Eigenschaften von allgemeinen Webserversteuerelementen

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

Die in der folgenden Tabelle aufgelisteten Eigenschaften gelten für alle Webserversteuerelemente, die von der WebControl-Klasse abgeleitet sind. Zu den Webserversteuerelementen, die nicht von der WebControl-Klasse erben, zählen unter anderem Literal, PlaceHolder, Repeater und Xml.

Eigenschaften

AccessKey

Die Tastenkombination für das Steuerelement (AccessKey). Diese Eigenschaft gibt einen Buchstaben oder eine Zahl an, den bzw. die der Benutzer drückt, während er ALT gedrückt hält. Geben Sie beispielsweise "K" an, wenn der Benutzer ALT+K drücken soll, um auf das Steuerelement zuzugreifen. Tastenkombinationen werden nur in Microsoft Internet Explorer, Version 4.0 oder höher, unterstützt.

Attributes

Die Auflistung von zusätzlichen Attributen des Steuerelements, die nicht durch eine öffentliche Eigenschaft definiert sind, jedoch ebenfalls dargestellt werden sollen. Jedes Attribut, das nicht durch das Webserversteuerelement definiert ist, wird dieser Auflistung hinzugefügt. Dadurch können Sie ein HTML‑Attribut verwenden, das nicht direkt durch das Steuerelement unterstützt wird.

NoteNote
Diese Eigenschaft kann nur während der Programmierung verwendet werden. Sie kann nicht bei der Deklaration des Steuerelements festgelegt werden.

BackColor

Die Hintergrundfarbe des Steuerelements. Die BackColor-Eigenschaft kann mit Standard-HTML-Farbbezeichnern festgelegt werden: mit dem Namen einer Farbe ("black" oder "red") oder einem im Hexadezimalformat ausgedrückten RGB-Wert ("#ffffff").

BorderColor

Die Rahmenfarbe des Steuerelements. Die BorderColor-Eigenschaft kann mit Standard-HTML-Farbbezeichnern festgelegt werden: mit dem Namen einer Farbe ("black" oder "red") oder einem im Hexadezimalformat ausgedrückten RGB-Wert ("#ffffff").

BorderWidth

Die Stärke des Rahmens des Steuerelements in Pixel, falls ein Rahmen vorhanden ist.

NoteNote
Bei Browsern, die älter als Internet Explorer 4.0 sind, ist diese Eigenschaft möglicherweise nicht bei allen Steuerelementen funktionsfähig.

BorderStyle

Das Rahmenformat für das Steuerelement, falls zutreffend. Mögliche Werte sind:

  • NotSet

  • None

  • Dotted

  • Dashed

  • Solid

  • Double

  • Groove

  • Ridge

  • Inset

  • Outset

CssClass

Die CSS (Cascading Style Sheet)-Klasse, die dem Steuerelement zugewiesen werden soll.

Style

Eine Auflistung von Textattributen, die als CSS‑Formatattribut am äußeren Tag des Steuerelements dargestellt werden.

NoteNote
Sämtliche Stilwerte, die mithilfe von Stileigenschaften (z. B. BackColor) festgelegt wurden, überschreiben automatisch den entsprechenden Wert in dieser Auflistung.Die mit dieser Eigenschaft gesetzten Werte werden nicht automatisch in den mit starkem Namen angegebenen Formateigenschaften wiedergegeben.

Manche Steuerelemente unterstützen Formatobjekte, mit denen Sie Formateigenschaften auf einzelne Elemente des Steuerelements anwenden können. Diese Eigenschaften überschreiben alle Einstellungen, die Sie mit der Style-Eigenschaft angegeben haben.

Enabled

Aktiviert das Steuerelement, wenn diese Eigenschaft auf true festgelegt wird (Standardwert). Das Steuerelement wird deaktiviert, wenn diese Eigenschaft den Wert false hat.

NoteNote
Beim Deaktivieren eines Steuerelements wird das Steuerelement abgeblendet und kann nicht weiter verwendet werden.Das Steuerelement wird hierdurch jedoch nicht verborgen.

EnableTheming

Aktiviert die Dauerhaftigkeit des Ansichtszustands für das Steuerelement, wenn diese Eigenschaft auf true festgelegt wird (Standardwert). Die Dauerhaftigkeit des Ansichtszustands für dieses Steuerelement wird deaktiviert, wenn diese Eigenschaft den Wert false hat.

EnableViewState

Aktiviert Designs für das Steuerelement, wenn diese Eigenschaft auf true festgelegt wird (Standardwert). Designs werden für dieses Steuerelement deaktiviert, wenn diese Eigenschaft den Wert false hat.

Font

Stellt Schriftinformationen für das Webserversteuerelement bereit, das Sie gerade deklarieren. Diese Eigenschaft umfasst Untereigenschaften, die Sie mithilfe der Eigenschaft-Untereigenschaft-Syntax im öffnenden Tag eines Elements eines Webserversteuerelements deklarieren können. Sie können z. B. den Text eines Webserversteuerelements fett formatieren, indem Sie das Font-Bold-Attribut in dessen Starttag einfügen.

ForeColor

Die Vordergrundfarbe des Steuerelements.

NoteNote
Bei Browsern, die älter als Internet Explorer 4.0 sind, ist diese Eigenschaft möglicherweise nicht bei allen Steuerelementen funktionsfähig.

Height

Die Höhe des Steuerelements.

NoteNote
Bei Browsern, die älter als Internet Explorer 4.0 sind, ist diese Eigenschaft möglicherweise nicht bei allen Steuerelementen funktionsfähig.

SkinID

Die Skin, die auf das Steuerelement angewendet wird.

TabIndex

Die Position des Steuerelements in der Aktivierreihenfolge. Wird diese Eigenschaft nicht festgelegt, so ist der Positionsindex des Steuerelements 0 (null). Bei Steuerelementen mit demselben Registerkartenindex können die Registerkarten in der Reihenfolge angeordnet werden, in der sie auf der Webseite deklariert sind.

NoteNote
Diese Eigenschaft funktioniert nur in Internet Explorer 4.0 oder höher.

ToolTip

Der Text, der angezeigt wird, wenn der Benutzer den Mauszeiger über einem Steuerelement positioniert.

NoteNote
Die ToolTip-Eigenschaft funktioniert nicht in allen Browsern.Überprüfen Sie die Kompatibilität des Browsers.

Width

Die feste Breite des Steuerelements. Mögliche Einheiten sind:

  • Pixel (px)

  • Punkt (pt)

  • Pica (pc)

  • Zoll (in)

  • Mm (mm)

  • Cm (cm)

  • Prozentsatz (%)

  • Em (em)

  • Ex (ex)

Eine Breite von 100 Punkten würden Sie z. B. mit 100pt deklarativ festlegen. Informationen über das programmgesteuerte Festlegen der Breite finden Sie unter How to: Set Web Server Control Unit Properties.

NoteNote
Die Standardeinheit ist Pixel.Nicht alle Browser unterstützen alle Einheiten.

Siehe auch

Referenz

System.Web.UI.WebControls

Weitere Ressourcen

Syntax des Webserversteuerelements