ASP.NET ListItem-Steuerelement

Web Server ControlsWebserversteuerelemente

Definition und Verwendung

Das ListItem-Steuerelement kann ein Element in einer Liste erstellen.

Dieses Steuerelement wird zusammen mit den folgenden Listensteuerelementen verwendet:<asp:ListBox>、 <asp:RadioButtonList>und<asp:BulletedList>。

Syntax

<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="label"
Value="value" />

Eigenschaften

Eigenschaften Beschreibung .NET
Attribute Optional. Eine Sammlung von Attributname/Wert-Paaren für das ListItem, die von dieser Klasse nicht direkt unterstützt werden. 1.0
Enabled Optional. Gibt an, ob das Element deaktiviert oder aktiviert ist. 2.0
Selected Optional. Gibt an, ob das Element ausgewählt ist. 1.0
Text Optional. Der im ListItem angezeigte Text. 1.0
Wert Optional. Der Wert des ListItem. 1.0

Standardeigenschaften von Websteuerelementen

AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width

Für eine vollständige Beschreibung besuchen SieStandardeigenschaften von Web-Steuerelementen。

Standardeigenschaften von Steuerelementen

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible

Für eine vollständige Beschreibung besuchen SieStandardeigenschaften von Steuerelementen。

Es ist möglich, die Text- oder Value-Eigenschaft sowie den inneren HTML-Text zu verwenden, um den für das Listenelement angezeigten Text festzulegen.

Beispiele

<asp:ListItem Value="Text1" Text="Text2">Text3</asp:ListItem>

Je nach Kombination aus Text- oder Value-Eigenschaft und dem inneren HTML-Text können unterschiedlicher Text angezeigt und unterschiedliche Werte verwendet werden. Die folgende Tabelle listet alle möglichen Kombinationen und deren Ergebnisse auf:

Inneres HTML Text-Eigenschaft Value-Eigenschaft Angezeigter Text Verwendeter Wert
Set Set Set Inneres HTML Value-Eigenschaft
Set Set Nicht festgelegt Inneres HTML Inneres HTML
Set Nicht festgelegt Set Inneres HTML Value-Eigenschaft
Set Nicht festgelegt Nicht festgelegt Inneres HTML Inneres HTML
Nicht festgelegt Set Set Text-Eigenschaft Value-Eigenschaft
Nicht festgelegt Set Nicht festgelegt Text-Eigenschaft Text-Eigenschaft
Nicht festgelegt Nicht festgelegt Set Value-Eigenschaft Value-Eigenschaft
Nicht festgelegt Nicht festgelegt Nicht festgelegt Nicht festgelegt Nicht festgelegt

Tipps und Hinweise

Hinweis:Da sowohl die Text- als auch die Value-Eigenschaft eine leere Zeichenfolge als Standardwert haben, können Listensteuerelemente leere Listenelemente enthalten.

Beispiele

BulletedList mit einfachem ListItem
Dieses Beispiel veranschaulicht ein BulletedList-Steuerelement mit zwei ListItems in einer .aspx-Datei.

ListBox mit ListItems mit unterschiedlichen Eigenschaften
Dieses Beispiel veranschaulicht ein ListBox-Steuerelement mit mehreren ListItems in einer .aspx-Datei. Die Elemente in der Liste verwenden unterschiedliche Eigenschaften, um den Text des ListItem anzuzeigen.

ListBox mit einem deaktivierten ListItem
Dieses Beispiel zeigt ein ListBox-Steuerelement mit einem deaktivierten ListItem.

RadioButtonList mit einem ausgewählten ListItem
Dieses Beispiel zeigt ein RadioButtonList-Steuerelement mit einem ausgewählten ListItem.

Web Server ControlsWebserver-Steuerelemente Weitere Erweiterungen