DataList Classe

Définition

Contrôle de liste lié aux données qui affiche des éléments à l’aide de modèles.

public ref class DataList : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IRepeatInfoUser
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser
type DataList = class
    inherit BaseDataList
    interface INamingContainer
    interface IRepeatInfoUser
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DataList = class
    inherit BaseDataList
    interface INamingContainer
    interface IRepeatInfoUser
Public Class DataList
Inherits BaseDataList
Implements INamingContainer, IRepeatInfoUser
Héritage
Attributs
Implémente

Exemples

L’exemple de code suivant montre comment utiliser un DataList contrôle pour afficher une liste d’éléments à partir d’une source de données.

Notes

L’exemple de code suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET modèle de code de page Web Forms.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
 
      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataList control.
         Dim dt As DataTable = New DataTable()
         dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
         dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 To 8 

            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Description for item " & i.ToString()
            dr(2) = 1.23 * (i + 1)
            dr(3) = "Image" & i.ToString() & ".jpg"
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object, e As EventArgs) 

         ' Load sample data only once, when the page is first loaded.
         If Not IsPostBack Then 
     
            ItemsList.DataSource = CreateDataSource()
            ItemsList.DataBind()
         
         End If

      End Sub
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>

Remarques

Dans cette rubrique :

Introduction

Utilisez le DataList contrôle pour afficher une liste liée aux données définies par un modèle. Le DataList contrôle prend en charge la sélection et la modification.

Modèles

Le contenu du contrôle peut être manipulé à l’aide DataList de modèles. Le tableau suivant répertorie les modèles pris en charge.

Nom du modèle Description
AlternatingItemTemplate S’il est défini, fournit le contenu et la disposition pour l’alternance d’éléments dans le DataList. S’il n’est pas défini, ItemTemplate est utilisé.
EditItemTemplate S’il est défini, fournit le contenu et la disposition de l’élément en cours de modification dans .DataList S’il n’est pas défini, ItemTemplate est utilisé.
FooterTemplate S’il est défini, fournit le contenu et la disposition de la section pied de page du DataList. Si elle n’est pas définie, une section de pied de page n’est pas affichée.
HeaderTemplate S’il est défini, fournit le contenu et la disposition de la section d’en-tête du DataList. Si elle n’est pas définie, une section d’en-tête n’est pas affichée.
ItemTemplate Modèle obligatoire qui fournit le contenu et la disposition des éléments dans .DataList
SelectedItemTemplate S’il est défini, fournit le contenu et la disposition de l’élément actuellement sélectionné dans .DataList S’il n’est pas défini, ItemTemplate est utilisé.
SeparatorTemplate S’il est défini, fournit le contenu et la disposition du séparateur entre les éléments du DataList. S’il n’est pas défini, un séparateur n’est pas affiché.

Au minimum, le ItemTemplate doit être défini pour afficher les éléments dans le DataList contrôle. Des modèles supplémentaires peuvent être utilisés pour fournir une apparence personnalisée au DataList contrôle.

Personnalisation de l’apparence du contrôle DataList

L’apparence du DataList contrôle peut être personnalisée en définissant les propriétés de style pour les différentes parties du contrôle. Le tableau suivant répertorie les différentes propriétés de style.

Style, propriété Description
AlternatingItemStyle Spécifie le style pour l’alternance d’éléments dans le DataList contrôle.
EditItemStyle Spécifie le style de l’élément en cours de modification dans le DataList contrôle.
FooterStyle Spécifie le style du pied de page dans le DataList contrôle.
HeaderStyle Spécifie le style de l’en-tête dans le DataList contrôle.
ItemStyle Spécifie le style des éléments du DataList contrôle.
SelectedItemStyle Spécifie le style de l’élément sélectionné dans le DataList contrôle.
SeparatorStyle Spécifie le style du séparateur entre les éléments du DataList contrôle.

Vous pouvez également afficher ou masquer différentes parties du contrôle. Le tableau suivant répertorie les propriétés qui contrôlent les parties affichées ou masquées.

Propriété Description
ShowFooter Affiche ou masque la section pied de page du DataList contrôle.
ShowHeader Affiche ou masque la section d’en-tête du DataList contrôle.

Direction et disposition d’affichage

Le sens d’affichage d’un DataList contrôle peut être vertical ou horizontal. Définissez la RepeatDirection propriété pour spécifier le sens d’affichage.

La disposition du DataList contrôle est contrôlée avec la RepeatLayout propriété . La définition de cette propriété sur RepeatLayout.Table affiche le DataList dans un format de tableau, tout en RepeatLayout.Flow affichant le DataList sans structure de table.

Sécurité

Le DataList contrôle peut contenir des contrôles qui permettent aux utilisateurs d’entrer des informations.

Attention

Ce contrôle peut être utilisé pour afficher l’entrée utilisateur, qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou tout autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier l’entrée utilisateur avant d’afficher le texte d’entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de demande d’entrée pour bloquer le script et le code HTML dans l’entrée utilisateur.

Pour plus d’informations sur la sécurité, consultez Sécurisation des contrôles standard, Guide pratique pour se protéger contre les attaques de script dans une application web en appliquant l’encodage HTML à des chaînes et Validation des entrées utilisateur dans ASP.NET pages web.

Syntaxe déclarative

<asp:DataList  
    AccessKey="string"  
    BackColor="color name|#dddddd"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    Caption="string"  
    CaptionAlign="NotSet|Top|Bottom|Left|Right"  
    CellPadding="integer"  
    CellSpacing="integer"  
    CssClass="string"  
    DataKeyField="string"  
    DataMember="string"  
    DataSource="string"  
    DataSourceID="string"  
    EditItemIndex="integer"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ExtractTemplateRows="True|False"  
    Font-Bold="True|False"  
    Font-Italic="True|False"  
    Font-Names="string"  
    Font-Overline="True|False"  
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|  
        Large|X-Large|XX-Large"  
    Font-Strikeout="True|False"  
    Font-Underline="True|False"  
    ForeColor="color name|#dddddd"  
    GridLines="None|Horizontal|Vertical|Both"  
    Height="size"  
    HorizontalAlign="NotSet|Left|Center|Right|Justify"  
    ID="string"  
    OnCancelCommand="CancelCommand event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleteCommand="DeleteCommand event handler"  
    OnDisposed="Disposed event handler"  
    OnEditCommand="EditCommand event handler"  
    OnInit="Init event handler"  
    OnItemCommand="ItemCommand event handler"  
    OnItemCreated="ItemCreated event handler"  
    OnItemDataBound="ItemDataBound event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelectedIndexChanged="SelectedIndexChanged event handler"  
    OnUnload="Unload event handler"  
    OnUpdateCommand="UpdateCommand event handler"  
    RepeatColumns="integer"  
    RepeatDirection="Horizontal|Vertical"  
    RepeatLayout="Table|Flow"  
    runat="server"  
    SelectedIndex="integer"  
    ShowFooter="True|False"  
    ShowHeader="True|False"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    ToolTip="string"  
    UseAccessibleHeader="True|False"  
    Visible="True|False"  
    Width="size"  
>  
        <AlternatingItemStyle />  
        <AlternatingItemTemplate>  
            <!-- child controls -->  
        </AlternatingItemTemplate>  
        <EditItemStyle />  
        <EditItemTemplate>  
            <!-- child controls -->  
        </EditItemTemplate>  
        <FooterStyle />  
        <FooterTemplate>  
            <!-- child controls -->  
        </FooterTemplate>  
        <HeaderStyle />  
        <HeaderTemplate>  
            <!-- child controls -->  
        </HeaderTemplate>  
        <ItemStyle />  
        <ItemTemplate>  
            <!-- child controls -->  
        </ItemTemplate>  
        <SelectedItemStyle />  
        <SelectedItemTemplate>  
            <!-- child controls -->  
        </SelectedItemTemplate>  
        <SeparatorStyle />  
        <SeparatorTemplate>  
            <!-- child controls -->  
        </SeparatorTemplate>  
</asp:DataList>  

Constructeurs

DataList()

Initialise une nouvelle instance de la classe DataList.

Champs

CancelCommandName

Représente le nom de la commande Cancel. Ce champ est en lecture seule.

DeleteCommandName

Représente le nom de la commande Delete. Ce champ est en lecture seule.

EditCommandName

Représente le nom de la commande Edit. Ce champ est en lecture seule.

SelectCommandName

Représente le nom de la commande Select. Ce champ est en lecture seule.

UpdateCommandName

Représente le nom de la commande Update. Ce champ est en lecture seule.

Propriétés

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web.

(Hérité de WebControl)
Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.

(Hérité de Control)
AlternatingItemStyle

Obtient les propriétés de style des éléments de remplacement dans le contrôle DataList.

AlternatingItemTemplate

Obtient ou définit le modèle pour les éléments de remplacement dans DataList.

AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle.

(Hérité de WebControl)
BackColor

Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web.

(Hérité de WebControl)
BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.

(Hérité de Control)
BorderColor

Obtient ou définit la couleur de bordure du contrôle Web.

(Hérité de WebControl)
BorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.

(Hérité de WebControl)
BorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.

(Hérité de WebControl)
Caption

Obtient ou définit le texte à afficher dans un élément de légende HTML du contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.

(Hérité de BaseDataList)
CaptionAlign

Obtient ou définit la position horizontale ou verticale de l'élément de légende HTML dans un contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.

(Hérité de BaseDataList)
CellPadding

Obtient ou définit l'espace entre le contenu d'une cellule et la bordure de celle-ci.

(Hérité de BaseDataList)
CellSpacing

Obtient ou définit l'espace entre les cellules.

(Hérité de BaseDataList)
ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.

(Hérité de Control)
ClientIDMode

Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID.

(Hérité de Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.

(Hérité de Control)
Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.

(Hérité de Control)
Controls

Obtient un objet ControlCollection qui contient une collection de contrôles enfants dans un contrôle de liste de données.

(Hérité de BaseDataList)
ControlStyle

Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CssClass

Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client.

(Hérité de WebControl)
DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.

(Hérité de Control)
DataKeyField

Obtient ou définit le champ clé de la source de données spécifiée par la propriété DataSource.

(Hérité de BaseDataList)
DataKeys

Obtient un objet DataKeyCollection qui stocke les valeurs de clés de chaque enregistrement dans un contrôle de liste de données.

(Hérité de BaseDataList)
DataKeysArray

Obtient un objet ArrayList qui contient les valeurs de clés de chaque enregistrement dans un contrôle de liste de données.

(Hérité de BaseDataList)
DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.

(Hérité de Control)
DataMember

Dans une source de données multimembre, obtient ou définit des données membres spécifiques à lier à un contrôle de liste de données.

(Hérité de BaseDataList)
DataSource

Obtient ou définit la source contenant une liste de valeurs utilisée pour remplir les éléments dans le contrôle.

(Hérité de BaseDataList)
DataSourceID

Obtient ou définit la propriété ID du contrôle de source de données que le contrôle de liste de données doit utiliser pour récupérer sa source de données.

(Hérité de BaseDataList)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.

(Hérité de Control)
EditItemIndex

Obtient ou définit le numéro d'index de l'élément sélectionné dans le contrôle DataList à modifier.

EditItemStyle

Obtient les propriétés de style pour l'élément sélectionné à modifier dans le contrôle DataList.

EditItemTemplate

Obtient ou définit le modèle pour l'élément sélectionné à modifier dans le contrôle DataList.

Enabled

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.

(Hérité de WebControl)
EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle.

(Hérité de WebControl)
EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule.

(Hérité de Control)
ExtractTemplateRows

Obtient ou définit une valeur qui indique si les lignes d'un contrôle Table, définies dans chaque modèle d'un contrôle DataList, sont extraites et affichées.

Font

Obtient les propriétés de police associées au contrôle serveur Web.

(Hérité de WebControl)
FooterStyle

Obtient les propriétés de style du pied de page du contrôle DataList.

FooterTemplate

Obtient ou définit le modèle pour le pied de page du contrôle DataList.

ForeColor

Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web.

(Hérité de WebControl)
GridLines

Obtient ou définit le style du quadrillage du contrôle DataList lorsque RepeatLayout.Table est affecté à la propriété RepeatLayout.

HasAttributes

Obtient une valeur indiquant si le contrôle a des attributs définis.

(Hérité de WebControl)
HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés.

(Hérité de Control)
HeaderStyle

Obtient les propriétés de style pour l'en-tête du contrôle DataList.

HeaderTemplate

Obtient ou définit le modèle pour l'en-tête du contrôle DataList.

Height

Obtient ou définit la hauteur du contrôle serveur Web.

(Hérité de WebControl)
HorizontalAlign

Obtient ou définit l'alignement horizontal du contrôle de liste de données dans son conteneur.

(Hérité de BaseDataList)
ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.

(Hérité de Control)
Initialized

Obtient une valeur indiquant si le contrôle a été initialisé.

(Hérité de BaseDataList)
IsBoundUsingDataSourceID

Obtient une valeur indiquant si la propriété DataSourceID est définie.

(Hérité de BaseDataList)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.

(Hérité de Control)
IsEnabled

Obtient une valeur indiquant si le contrôle est activé.

(Hérité de WebControl)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.

(Hérité de Control)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.

(Hérité de Control)
Items

Obtient une collection d'objets DataListItem représentant les éléments contenus dans le contrôle.

ItemStyle

Obtient les propriétés de style pour les éléments dans le contrôle DataList.

ItemTemplate

Obtient ou définit le modèle pour les éléments dans le contrôle DataList.

LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.

(Hérité de Control)
NamingContainer

Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur.

(Hérité de Control)
Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.

(Hérité de Control)
Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.

(Hérité de Control)
RepeatColumns

Obtient ou définit le nombre de colonnes à afficher dans le contrôle DataList.

RepeatDirection

Obtient ou définit si le contrôle DataList s'affiche verticalement ou horizontalement.

RepeatLayout

Obtient ou définit si le contrôle s'affiche dans une mise en page tableau ou fluide.

RequiresDataBinding

Obtient ou définit une valeur indiquant si le contrôle de liste de données doit être lié à sa source de données spécifiée.

(Hérité de BaseDataList)
SelectArguments

Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données d'un contrôle de source de données.

(Hérité de BaseDataList)
SelectedIndex

Obtient ou définit l'index de l'élément sélectionné dans le contrôle DataList.

SelectedItem

Obtient l'élément sélectionné dans le contrôle DataList.

SelectedItemStyle

Obtient les propriétés de style pour l'élément sélectionné dans le contrôle DataList.

SelectedItemTemplate

Obtient ou définit le modèle pour l'élément sélectionné dans le contrôle DataList.

SelectedValue

Obtient la valeur du champ clé pour l'élément de liste de données sélectionné.

SeparatorStyle

Obtient les propriétés de style du séparateur entre chaque élément dans le contrôle DataList.

SeparatorTemplate

Obtient ou définit le modèle pour le séparateur entre les éléments du contrôle DataList.

ShowFooter

Obtient ou définit une valeur qui indique si le pied de page s'affiche dans le contrôle DataList.

ShowHeader

Obtient ou définit une valeur qui indique si l'en-tête s'affiche dans le contrôle DataList.

Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.

(Hérité de Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.

(Hérité de WebControl)
Style

Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web.

(Hérité de WebControl)
SupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false.

(Hérité de BaseDataList)
TabIndex

Obtient ou définit l'index de tabulation du contrôle serveur Web.

(Hérité de WebControl)
TagKey

Obtient la balise HTML utilisée pour afficher le contrôle DataList.

TagKey

Obtient la valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
TagName

Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.

(Hérité de Control)
ToolTip

Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web.

(Hérité de WebControl)
UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.

(Hérité de Control)
UseAccessibleHeader

Obtient ou définit une valeur indiquant si un contrôle de liste de données restitue son en-tête dans un format accessible. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.

(Hérité de BaseDataList)
ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses.

(Hérité de Control)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.

(Hérité de Control)
Visible

Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.

(Hérité de Control)
Width

Obtient ou définit la largeur du contrôle serveur web.

(Hérité de WebControl)

Méthodes

AddAttributesToRender(HtmlTextWriter)

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control.

(Hérité de Control)
AddParsedSubObject(Object)

Avertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à la collection ControlCollection du contrôle serveur.

(Hérité de BaseDataList)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de la page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.

(Hérité de Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearEffectiveClientIDMode()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.

(Hérité de Control)
CopyBaseAttributes(WebControl)

Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CreateChildControls()

Crée un contrôle enfant à l'aide de l'état d'affichage.

(Hérité de BaseDataList)
CreateControlCollection()

Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.

(Hérité de Control)
CreateControlHierarchy(Boolean)

Crée la hiérarchie de contrôles utilisée pour restituer le contrôle de liste de données, avec ou sans la source de données spécifiée.

CreateControlStyle()

Crée l'objet de style par défaut qui est utilisé de manière interne par le contrôle DataList pour implémenter toutes les propriétés associées au style.

CreateDataSourceSelectArguments()

Crée un objet DataSourceSelectArguments par défaut utilisé par le contrôle lié aux données si aucun argument n'est spécifié.

(Hérité de BaseDataList)
CreateItem(Int32, ListItemType)

Crée un objet DataListItem.

DataBind()

Lie le contrôle et tous ses contrôles enfants à la source de données spécifiée.

(Hérité de BaseDataList)
DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.

(Hérité de Control)
Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée.

(Hérité de Control)
EnsureDataBound()

Vérifie que le contrôle de liste de données requiert la liaison de données et qu'un contrôle de source de données valide est spécifié avant d'appeler la méthode DataBind().

(Hérité de BaseDataList)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.

(Hérité de Control)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
Focus()

Affecte le focus d'entrée à un contrôle.

(Hérité de Control)
GetData()

Retourne un objet implémentant IEnumerable qui représente la source de données.

(Hérité de BaseDataList)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.

(Hérité de Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.

(Hérité de Control)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.

(Hérité de Control)
InitializeItem(DataListItem)

Initialise un objet DataListItem en fonction des modèles et des styles spécifiés pour le type d'élément de liste.

IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().

(Hérité de Control)
LoadViewState(Object)

Charge l'état d'affichage enregistré précédemment du contrôle DataList.

MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.

OnCancelCommand(DataListCommandEventArgs)

Déclenche l’événement CancelCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

OnDataBinding(EventArgs)

Déclenche l'événement DataBinding d'un contrôle BaseDataList.

(Hérité de BaseDataList)
OnDataPropertyChanged()

Cette méthode est appelée lorsque l'une des propriétés de base d'identification de la source de données est modifiée, pour relier le contrôle lié aux données à ses données.

(Hérité de BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)

Déclenche l’événement DataSourceViewChanged.

(Hérité de BaseDataList)
OnDeleteCommand(DataListCommandEventArgs)

Déclenche l’événement DeleteCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

OnEditCommand(DataListCommandEventArgs)

Déclenche l’événement EditCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

OnInit(EventArgs)

Déclenche l'événement Init pour le contrôle DataList.

OnInit(EventArgs)

Déclenche l'événement Init pour le contrôle BaseDataList.

(Hérité de BaseDataList)
OnItemCommand(DataListCommandEventArgs)

Déclenche l’événement ItemCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

OnItemCreated(DataListItemEventArgs)

Déclenche l’événement ItemCreated. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

OnItemDataBound(DataListItemEventArgs)

Déclenche l’événement ItemDataBound. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

OnLoad(EventArgs)

Déclenche l’événement Load.

(Hérité de BaseDataList)
OnPreRender(EventArgs)

Déclenche l’événement PreRender.

(Hérité de BaseDataList)
OnSelectedIndexChanged(EventArgs)

Déclenche l'événement SelectedIndexChanged d'un contrôle BaseDataList.

(Hérité de BaseDataList)
OnUnload(EventArgs)

Déclenche l’événement Unload.

(Hérité de Control)
OnUpdateCommand(DataListCommandEventArgs)

Déclenche l’événement UpdateCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.

(Hérité de Control)
PrepareControlHierarchy()

Prépare la hiérarchie de contrôles à restituer dans le contrôle DataList.

RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.

(Hérité de Control)
RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.

(Hérité de Control)
Render(HtmlTextWriter)

Génère le rendu du contrôle via le writer HTML spécifié.

(Hérité de BaseDataList)
RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderContents(HtmlTextWriter)

Génère le rendu des éléments de liste dans le contrôle DataList.

RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.

(Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

(Hérité de Control)
RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.

(Hérité de Control)
SaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.

(Hérité de Control)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage du contrôle depuis la publication de la page sur le serveur.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TrackViewState()

Suit les modifications d'état d'affichage du contrôle DataList afin qu'elles puissent être stockées dans la propriété ViewState du contrôle.

Événements

CancelCommand

Se produit lorsqu'un clic est effectué sur le bouton Cancel pour un élément dans le contrôle DataList.

DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.

(Hérité de Control)
DeleteCommand

Se produit lorsqu'un clic est effectué sur le bouton Delete pour un élément dans le contrôle DataList.

Disposed

Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET.

(Hérité de Control)
EditCommand

Se produit lorsqu'un clic est effectué sur le bouton Edit pour un élément dans le contrôle DataList.

Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie.

(Hérité de Control)
ItemCommand

Se produit lorsqu'un clic est effectué sur n'importe quel bouton dans le contrôle DataList.

ItemCreated

Se produit sur le serveur lors de la création d'un élément dans le contrôle DataList.

ItemDataBound

Se produit lorsqu'un élément est lié aux données du contrôle DataList.

Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.

(Hérité de Control)
PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.

(Hérité de Control)
SelectedIndexChanged

Se produit lorsque, dans un contrôle de liste de données, un élément différent est sélectionné entre deux publications sur le serveur.

(Hérité de BaseDataList)
Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)
UpdateCommand

Se produit lorsqu'un clic est effectué sur le bouton Update pour un élément dans le contrôle DataList.

Implémentations d’interfaces explicites

IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.

(Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.

(Hérité de WebControl)
IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.

(Hérité de Control)
IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.

(Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

(Hérité de Control)
IRepeatInfoUser.GetItemStyle(ListItemType, Int32)

Pour obtenir une description de ce membre, consultez GetItemStyle(ListItemType, Int32).

IRepeatInfoUser.HasFooter

Pour obtenir une description de ce membre, consultez HasFooter.

IRepeatInfoUser.HasHeader

Pour obtenir une description de ce membre, consultez HasHeader.

IRepeatInfoUser.HasSeparators

Pour obtenir une description de ce membre, consultez HasSeparators.

IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)

Pour obtenir une description de ce membre, consultez RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter).

IRepeatInfoUser.RepeatedItemCount

Pour obtenir une description de ce membre, consultez RepeatedItemCount.

Méthodes d’extension

FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.

FindFieldTemplate(Control, String)

Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.

GetDefaultValues(INamingContainer)

Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.

GetMetaTable(INamingContainer)

Obtient les métadonnées de table pour le contrôle de données spécifié.

SetMetaTable(INamingContainer, MetaTable)

Définit les métadonnées de table pour le contrôle de données spécifié.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.

SetMetaTable(INamingContainer, MetaTable, Object)

Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.

TryGetMetaTable(INamingContainer, MetaTable)

Détermine si des métadonnées de table sont disponibles.

EnableDynamicData(INamingContainer, Type)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type, Object)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

S’applique à

Voir aussi