Share via


Freigegebene Eigenschaften für HTML-Steuerelemente

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Da ASP.NET ein Teil von .NET Framework ist, funktioniert die Vererbung auch für alle Namespaces und Klassen in ASP.NET. Es gibt zwei Teilmengen von HTML-Steuerelementen, die Eigenschaften aus unterschiedlichen Basisklassen gemeinsam verwenden. Diese Teilmengen werden als Containersteuerelemente und Eingabesteuerelemente bezeichnet.

Jedes Attribut, das für ein HTML-Steuerelement deklariert wird, wird der Attributes-Auflistung des Steuerelements hinzugefügt und kann programmgesteuert wie eine Eigenschaft bearbeitet werden. Wenn Sie beispielsweise ein bgcolor-Attribut für ein <body>-Element deklarieren, können Sie programmgesteuert auf das Attribut zugreifen und Ereignishandler schreiben, um den Wert des Attributs zu ändern.

Eigenschaften, die von allen HTML-Steuerelementen verwendet werden

Attributes

Ruft alle Attributname-Wert-Paare ab, die innerhalb einer ausgewählten ASP.NET-Seite in einem Serversteuerelementtag ausgedrückt werden.

NoteNote
In HTML-Serversteuerelementen hat das Ändern der Attributes-Auflistung dieselben Auswirkungen wie das Ändern der Control.ViewState-Eigenschaft.

Disabled

Ruft einen Wert ab, der angibt, ob das disabled-Attribut bei der Darstellung eines HTML-Steuerelements in einem Browser verwendet wird, oder legt diesen fest. Wenn Sie dieses Attribut einfügen, ist das Steuerelement schreibgeschützt.

Style

Ruft alle CSS (Cascading Stylesheet)-Eigenschaften ab, die in einer .aspx-Datei auf ein angegebenes HTML-Serversteuerelement angewendet werden.

TagName

Ruft den Elementnamen eines Tags ab, das ein runat="server"-Attribut enthält.

Visible

Ruft einen Wert ab, der angibt, ob das HTML-Serversteuerelement auf der Seite angezeigt wird, oder legt diesen fest.

Eigenschaften, die von allen HTML-Eingabesteuerelementen verwendet werden

HTML-Eingabesteuerelemente werden den Standard-HTML-Eingabeelementen zugeordnet. Sie enthalten ein type-Attribut, das den Typ von Eingabesteuerelement definiert, den sie auf einer Webseite rendern.

Die Steuerelemente HtmlInputText, HtmlInputPassword, HtmlInputButton, HtmlInputSubmit, HtmlInputReset, HtmlInputCheckBox, HtmlInputImage, HtmlInputHidden, HtmlInputFile und HtmlInputRadioButton verfügen alle über die im Folgenden genannten gemeinsamen Eigenschaften.

Name

Ruft einen eindeutigen Bezeichnernamen für das HtmlInputControl-Steuerelement ab oder legt diesen fest.

Value

Ruft den einem Eingabesteuerelement zugeordneten Wert ab oder legt diesen fest.

NoteNote
Der einem Steuerelement zugeordnete Wert hängt vom Kontext des Steuerelements ab.Bei Steuerelementen, die der Texteingabe dienen, z. B. dem HtmlInputText-Steuerelement, entspricht dieser Wert dem Text, der in das Steuerelement eingegeben wird.Bei Steuerelementen, die keine Texteingabe zulassen, z. B. dem HtmlInputButton-Steuerelement, entspricht der Wert der in dem Steuerelement angezeigten Beschriftung.Weitere Informationen zum Kontext der Value-Eigenschaft finden Sie in den Erläuterungen zu dem betreffenden Steuerelement.

Type

Ruft den Typ eines HtmlInputControl-Steuerelements ab. Wenn diese Eigenschaft z. B. auf text festgelegt ist, handelt es sich bei dem HtmlInputControl-Steuerelement um ein Textfeld für die Dateneingabe.

Eigenschaften, die von allen HTML-Containersteuerelementen verwendet werden

HTML-Containersteuerelemente werden HTML-Elementen zugeordnet, für die ein Start- sowie ein Endtag erforderlich ist, z. B. den Elementen <select>, <a>, <button> oder <form>.

Die Steuerelemente HtmlTableCell, HtmlTable, HtmlTableRow, HtmlButton, HtmlForm, HtmlAnchor, HtmlGenericControl, HtmlSelect und HtmlTextArea verfügen alle über die im Folgenden genannten gemeinsamen Eigenschaften.

InnerHtml

Ruft den Inhalt zwischen dem öffnenden und dem schließenden Tag des angegebenen HTML-Steuerelements ab oder setzt diesen. Die InnerHtml-Eigenschaft führt keine automatische Konvertierung von Sonderzeichen in HTML-Entitäten durch. So wird z. B. das Kleiner-als-Symbol (<) nicht automatisch in &lt; umgewandelt. Diese Eigenschaft wird häufig dazu verwendet, HTML-Elemente in das Containersteuerelement einzubetten.

InnerText

Ruft den gesamten Text zwischen dem öffnenden und dem schließenden Tag des angegebenen HTML-Steuerelements ab oder setzt diesen. Im Gegensatz zur InnerHtml-Eigenschaft konvertiert die InnerText-Eigenschaft Sonderzeichen automatisch in HTML-Entitäten. So wird z. B. das Kleiner-als-Symbol (<) in &lt; umgewandelt. Diese Eigenschaft wird in der Regel verwendet, wenn Text mit Sonderzeichen dargestellt werden soll, ohne dass die HTML-Entitäten angegeben werden.

Siehe auch

Referenz

HtmlInputControl

HtmlContainerControl

HtmlControl

Weitere Ressourcen

HTML-Serversteuerelemente