Exporter (0) Imprimer
Développer tout

ListBox, classe

Représente un contrôle zone de liste qui permet la sélection d'un seul ou de plusieurs éléments.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

[ValidationPropertyAttribute("SelectedItem")] 
public class ListBox : ListControl, IPostBackDataHandler
/** @attribute ValidationPropertyAttribute("SelectedItem") */ 
public class ListBox extends ListControl implements IPostBackDataHandler
ValidationPropertyAttribute("SelectedItem") 
public class ListBox extends ListControl implements IPostBackDataHandler

Utilisez le contrôle ListBox pour créer un contrôle de liste qui permet la sélection d'un seul ou de plusieurs éléments. Utilisez la propriété Rows pour spécifier la hauteur du contrôle. Pour permettre la sélection de plusieurs éléments, affectez ListSelectionMode.Multiple à la propriété SelectionMode.

Utilisez la collection Items pour examiner les objets ListItem contenus dans le contrôle ListBox. Par exemple, vous pouvez déterminer les éléments sélectionnés dans le contrôle ListBox en énumérant la collection Items et en testant la valeur Selected pour chaque élément ListItem.

AttentionAttention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client malveillant. Vérifiez toutes les informations envoyées par un client pour un script exécutable, des instructions SQL ou un autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier l'entrée d'utilisateur avant d'afficher le texte d'entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de la demande d'entrée pour bloquer les scripts et le code HTML dans les entrées d'utilisateur. Pour plus d'informations, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

RubriqueEmplacement
Procédure pas à pas : création d'éléments réutilisables avec des contrôles utilisateur ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web ListBox à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'éléments réutilisables avec des contrôles utilisateur ASP.NETGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans des contrôles serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web ListBox à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans des contrôles serveur Web ListGénération d'applications Web ASP.NET
Comment : déterminer la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web ListBox à une page Web FormsGénération d'applications Web ASP.NET
Comment : définir la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET
Comment : ajouter des éléments dans des contrôles serveur Web ListGénération d'applications Web ASP.NET
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : remplir des contrôles serveur Web List à partir d'une source de donnéesGénération d'applications Web ASP.NET
Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans des contrôles serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web ListBox à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio

L'exemple suivant illustre la création d'un contrôle ListBox.

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         if (ListBox1.SelectedIndex > -1)
            Label1.Text="You chose: " + ListBox1.SelectedItem.Text;
      }

   </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form runat=server>

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           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:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>

L'exemple suivant illustre la création d'un contrôle ListBox via la liaison de données.

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script language="C#" runat="server">

      void Page_Load(Object sender, EventArgs e) 
      {

         if (!IsPostBack) 
         {

            ArrayList values = new ArrayList();

            values.Add ("Item 1");
            values.Add ("Item 2");
            values.Add ("Item 3");
            values.Add ("Item 4");
            values.Add ("Item 5");
            values.Add ("Item 6");

            ListBox1.DataSource = values;
            ListBox1.DataBind();

         }

      }

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
      
         if ( ListBox1.SelectedIndex > -1 )
            Label1.Text = "You chose: " + ListBox1.SelectedItem.Text;
         
      }

   </script>

</head>
<body>

   <form runat=server>

        <h3>Data Binding ListBox</h3>
    
        <asp:ListBox id="ListBox1" 
             Width="100px" 
             runat="server"/>

        <asp:button id="Button1"
             Text="Submit" 
             OnClick="SubmitBtn_Click" 
             runat="server" />
        
        <asp:Label id="Label1" 
             font-name="Verdana" 
             font-size="10pt" 
             runat="server"/>

   </form>

</body>
</html>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : LinkDemand. Valeur d'autorisation : Minimal.
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : InheritanceDemand. Valeur d'autorisation : Minimal.

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft