Contrôle ListItem

ASP.NET ListItem Contrôle

Contrôle du serveur Web

Définition et utilisation

Le contrôle ListItem peut Créez un élément dans la liste.

Ce contrôle est utilisé avec les contrôles de liste suivants : <asp:ListBox>, <asp:RadioButtonList> et <asp:BulletedList>.

Syntaxe

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

attribut

属性	描述	.NET
Attributes	可选的。此类不直接支持的 ListItem 的属性名和值对的集合。	1.0
Enabled	可选的。规定是否禁用或启用项目。	2.0
Selected	可选的。规定是否选定该项。	1.0
Text	可选的。在 ListItem 中显示的文本。	1.0
Value	可选的。ListItem 的值。	1.0

Propriétés standards du contrôle Web

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

Pour une description complète, visitez les propriétés standard du contrôle Web.

Propriétés standard du contrôle

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Contrôles, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible

Pour une description complète, visitez Propriétés standard de contrôle.

Il est possible de définir le texte de l'élément de liste affiché à l'aide de la propriété Text ou Value et du texte HTML interne.

Instance

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

Selon Les combinaisons de l'attribut Texte ou Valeur et du texte HTML interne peuvent afficher un texte différent et utiliser des valeurs différentes. Le tableau ci-dessous répertorie toutes les combinaisons possibles et leurs résultats :

Inner HTML	Text 属性	Value 属性	显示的文本	使用的值
已设置	已设置	已设置	Inner HTML	Value 属性
已设置	已设置	未设置	Inner HTML	Inner HTML
已设置	未设置	已设置	Inner HTML	Value 属性
已设置	未设置	未设置	Inner HTML	Inner HTML
未设置	已设置	已设置	Text 属性	Value 属性
未设置	已设置	未设置	Text 属性	Text 属性
未设置	未设置	已设置	Value 属性	Value 属性
未设置	未设置	未设置	未设置	未设置

Conseils et notes

Remarque : Étant donné que les propriétés Text et Value ont des valeurs par défaut de chaîne vide, il est possible d'avoir des éléments de liste vides dans la liste contrôle.

Exemple

BulletedList avec ListItem de base
Cet exemple montre un contrôle BulletedList avec deux ListItems dans un fichier .aspx.

ListBox avec ListItems avec des propriétés différentes
Cet exemple montre un contrôle ListBox avec plusieurs ListItems dans un fichier .aspx. Les éléments de la liste utilisent des propriétés différentes pour afficher le texte du ListItem.

ListBox avec ListItem désactivé
Cet exemple montre un contrôle ListBox avec ListItem désactivé.

RadioButtonList avec ListItem sélectionné
Cet exemple montre un contrôle RadioButtonList avec ListItem sélectionné.