ASP.NET ListItemContrôle

Web Server ControlsContrôles serveur Web

Définition et utilisation

Le contrôle ListItem peut créer un élément dans une 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" />

Propriétés

Propriétés Description .NET
Attributes Facultatif. Collection de paires nom/valeur d'attributs pour le ListItem qui ne sont pas directement prises en charge par cette classe. 1.0
Enabled Facultatif. Spécifie si l'élément est désactivé ou activé. 2.0
Selected Facultatif. Spécifie si l'élément est sélectionné. 1.0
Texte Facultatif. Le texte affiché dans le ListItem. 1.0
Valeur Facultatif. La valeur du ListItem. 1.0

Propriétés standard des contrôles Web

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

Pour une description complète, visitezPropriétés standard des contrôles Web。

Propriétés standard des contrôles

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

Pour une description complète, visitezPropriétés standard des contrôles。

Il est possible d'utiliser la propriété Text ou Value ainsi que le texte HTML interne pour définir le texte affiché pour l'élément de liste.

Exemples

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

Selon la combinaison de la propriété Text ou Value et du texte HTML interne, différents textes peuvent être affichés et différentes valeurs peuvent être utilisées. Le tableau suivant répertorie toutes les combinaisons possibles et leurs résultats :

HTML interne Propriété Text Propriété Value Texte affiché Valeur utilisée
Set Set Set HTML interne Propriété Value
Set Set Non défini HTML interne HTML interne
Set Non défini Set HTML interne Propriété Value
Set Non défini Non défini HTML interne HTML interne
Non défini Set Set Propriété Text Propriété Value
Non défini Set Non défini Propriété Text Propriété Text
Non défini Non défini Set Propriété Value Propriété Value
Non défini Non défini Non défini Non défini Non défini

Conseils et notes

Remarque :Comme les propriétés Text et Value ont une chaîne vide comme valeur par défaut, les contrôles de liste peuvent contenir des éléments de liste vides.

Exemples

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

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

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

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

Web Server ControlsContrôles serveur Web Autres extensions