Exporter (0) Imprimer
Développer tout
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ListControl, classe

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")] 
public abstract class ListControl : DataBoundControl, IEditableTextControl, ITextControl
/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, ITextControl
ControlValuePropertyAttribute("SelectedValue") 
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, ITextControl

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.


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

<html> 

<head>

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

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
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.