Cette documentation est archivée et n’est pas conservée.

ListControl, classe

Mise à jour : novembre 2007

Sert de classe de base abstraite définissant les propriétés, les méthodes et les événements communs à l'ensemble des contrôles de type liste.

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

[ControlValuePropertyAttribute("SelectedValue")]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public abstract class ListControl : DataBoundControl, 
	IEditableTextControl, ITextControl
/** @attribute ControlValuePropertyAttribute("SelectedValue") */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, 
	ITextControl
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, ITextControl
<asp:ListControl />

Il n'est pas possible de créer une instance de la classe abstraite ListControl directement. Cette classe est, en revanche, héritée par d'autres classes, telles que les classes CheckBoxList, DropDownList, ListBox et RadioButtonList, pour fournir une fonctionnalité de base commune.

Les propriétés de la classe ListControl vous permettent de spécifier la source de données pour remplir le contrôle de liste. Utilisez la propriété DataSource pour spécifier la source de données à associer au contrôle de liste. Si la source de données contient plusieurs tables, utilisez la propriété DataMember pour spécifier la table à utiliser. Vous pouvez lier plusieurs champs de la source de données aux propriétés ListItem.Text et ListItem.Value des éléments d'un contrôle de liste en définissant respectivement les propriétés DataTextField et DataValueField. Le texte affiché pour chaque élément du contrôle de liste peut être mis en forme en définissant la propriété DataTextFormatString.

Tous les éléments affichés dans le contrôle de liste sont stockés dans la collection Items. Utilisez la propriété SelectedIndex pour spécifier ou déterminer par programme l'index d'un élément sélectionné dans le contrôle de liste. Il est possible d'accéder aux propriétés de l'élément sélectionné à l'aide de la propriété SelectedItem.

La classe ListControl fournit l'événement SelectedIndexChanged qui est déclenché lorsque la sélection est modifiée dans le contrôle de liste entre des publications sur le serveur. Cela vous permet de fournir un gestionnaire personnalisé de cet événement. Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

La classe ListControl implémente l'interface IEditableTextControl afin que les contrôles de type liste dérivés puissent être utilisés avec le mode modèles d'autres contrôles.

L'exemple de code suivant illustre comment sélectionner des éléments dans un contrôle ListBox. Si l'élément est trouvé dans la zone de texte, il est sélectionné et un message indiquant le nom de l'élément sélectionné apparaît. S'il n'est pas trouvé, aucun élément n'est sélectionné et un message indiquant que l'élément n'a pas été trouvé apparaît.

Note de sécurité :

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.


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

<!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" > 

<head runat="server">
    <title> ListControl SelectedValue Example </title>
<script runat="server">

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }

      }

   </script>

</head>

<body>

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

      <h3> ListControl SelectedValue Example </h3>

      <asp:ListBox ID="List"
           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>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </form>

</body>
</html>


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

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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: