Langage de programmation - ASP.NET - Balises

ASP:LISTITEM	ASP : Liste d'item
ASP.NET

Syntaxe

<asp:ListItem paramètres />

<asp:ListItem paramètres>
texte
</asp:ListItem>

Paramètres

Paramètre	Description
texte	Ce paramètre de balise permet d'indiquer l'étiquette de texte de cette item.
Enabled=valeur	Ce paramètre permet d'indiquer si la balise doit être active ou non :
	Constante	Description
	"False"	Cette constante permet d'indiquer que la balise n'est pas active.
	"True"	Cette constante permet d'indiquer que la balise n'est pas active.
Selected=valeur	Ce paramètre permet d'indiquer si l'item est actuellement sélectionné ou non :
	Constante	Description
	"False"	Cette constante permet d'indiquer que l'item n'est pas sélectionné.
	"True"	Cette constante permet d'indiquer que l'item est sélectionné.
Text=valeur	Ce paramètre permet d'indiquer l'étiquette de texte.
Value=valeur	Ce paramètre de balise permet d'indiquer la valeur de cette item.

Description

Cette balise permet de définir un des choix d'un contrôle de choix avec les balises «ASP:CHECKBOXLIST», «ASP:DROPDOWNLIST», «ASP:LISTBOX» ou «ASP:RADIOBUTTONLIST».

Remarques

Le contrôle <asp:ListItem> représente un élément unique à l'intérieur d'une liste d'options, comme une CheckBoxList, DropDownList, ListBox ou RadioButtonList. Il définit ce que l'utilisateur peut voir et sélectionner.
La balise peut s'écrire en format auto-fermée ou avec un contenu texte entre les balises ouvrantes et fermantes. Les deux syntaxes permettent de spécifier les mêmes attributs.
Le paramètre Text définit le texte affiché à l'utilisateur. C'est ce que l'utilisateur voit à l'écran, indépendamment de la valeur réelle utilisée en arrière-plan pour le traitement.
Le paramètre Value, quant à lui, correspond à la donnée associée à l'item sélectionné. Il est souvent utilisé dans les traitements en code-behind pour récupérer un identifiant, un code ou une valeur métier.
L'attribut Selected="True" permet de présélectionner un élément dans la liste. C'est utile pour afficher une valeur par défaut lors du chargement initial de la page.
Un seul ListItem peut être sélectionné par défaut dans une DropDownList ou une RadioButtonList, mais plusieurs peuvent l'être dans une ListBox ou une CheckBoxList, si la configuration de la composante le permet.
L'attribut Enabled permet de désactiver un item. Lorsqu'il est mis à False, l'item apparaît grisé et ne peut pas être sélectionné par l'utilisateur.
Désactiver certains ListItem permet de guider l'utilisateur dans ses choix, par exemple pour des options temporairement indisponibles ou conditionnelles.
Le ListItem est souvent utilisé dans une boucle lors du remplissage dynamique d'une liste, par exemple en parcourant une collection et en ajoutant chaque valeur possible.
Cette composante joue un rôle crucial dans la création d'interfaces interactives où les utilisateurs doivent faire des choix dans une liste définie, simple ou complexe.
Un ListItem peut aussi servir de séparateur visuel dans une liste, en insérant par exemple des tirets ou des textes non cliquables (avec Enabled="False") pour structurer les options.
La gestion correcte de la propriété Value permet de dissocier l'affichage de la logique métier : on peut afficher "France" à l'écran tout en utilisant "FR" pour les traitements internes.
Quand plusieurs ListItem sont utilisés dans un même composant, il est important de s'assurer que leurs valeurs sont uniques pour éviter des incohérences à la sélection.
En code-behind, on peut parcourir une collection de ListItem pour identifier celui qui est sélectionné, ce qui est essentiel pour valider les données entrées par l'utilisateur.
Le ListItem est une composante simple mais puissant, qui permet de structurer proprement des options dans divers types de listes ASP.NET, tout en restant facile à manipuler côté serveur.

Exemple

Voici un exemple permettant d'afficher des listes :


	
			
				
<%@ Page Language="vb" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<body>

    <form id="MonFormulaire" runat="server">

        <asp:CheckBoxList id="MaListeCaseACocher" runat="server">

            <asp:ListItem>Case à cocher 1</asp:ListItem>

            <asp:ListItem>Case à cocher 2</asp:ListItem>

            <asp:ListItem>Case à cocher 3</asp:ListItem>

            <asp:ListItem>Case à cocher 4</asp:ListItem>

            <asp:ListItem>Case à cocher 5</asp:ListItem>

        </asp:CheckBoxList> 

        <asp:DropDownList id="DropDownListA" runat="server">

            <asp:ListItem>Item 1</asp:ListItem>

            <asp:ListItem>Item 2</asp:ListItem>

            <asp:ListItem>Item 3</asp:ListItem>

            <asp:ListItem>Item 4</asp:ListItem>

            <asp:ListItem>Item 5</asp:ListItem>

        </asp:DropDownList> 

        <asp:ListBox id="ListBox1" runat="server">

            <asp:ListItem>Item 1</asp:ListItem>

            <asp:ListItem>Item 2</asp:ListItem>

            <asp:ListItem>Item 3</asp:ListItem>

            <asp:ListItem>Item 4</asp:ListItem>

        </asp:ListBox> 

        <asp:RadioButtonList id="RadioButtonListA" runat="server">

            <asp:ListItem>Item 1</asp:ListItem>

            <asp:ListItem>Item 2</asp:ListItem>

            <asp:ListItem>Item 3</asp:ListItem>

            <asp:ListItem>Item 4</asp:ListItem>

        </asp:RadioButtonList>

    </form>

</body>

</html>

on obtiendra le résultat semblable suivant :

Voir également

Articles - Les géants de l'informatique - Microsoft

Dernière mise à jour : Samedi, le 31 août 2017

Section courante

A propos

Section administrative du site

ASP:LISTITEM