DataList Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Control

WebControl

BaseDataList
DataList

Attributs: ControlValuePropertyAttribute

Implémente: INamingContainer IRepeatInfoUser

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
Modèles
Personnalisation de l’apparence du contrôle DataList
Direction et disposition d’affichage
Sécurité
Syntaxe déclarative

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 à

Partager via