DataList Classe

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 les é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.

Note

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
Templates
Personnalisation de l’apparence du contrôle DataList
Afficher la direction et la disposition
Sécurité
Syntaxe déclarative

Présentation

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

Modèles

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

Nom du modèle	Description
AlternatingItemTemplate	Si elle est définie, fournit le contenu et la disposition des éléments alternés dans le DataList. S’il n’est pas défini, `ItemTemplate` il est utilisé.
EditItemTemplate	Si elle est définie, fournit le contenu et la disposition de l’élément en cours de modification dans le DataList. S’il n’est pas défini, `ItemTemplate` il est utilisé.
FooterTemplate	Si elle est définie, 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 ne s’affiche pas.
HeaderTemplate	Si elle est définie, 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 ne s’affiche pas.
ItemTemplate	Modèle obligatoire qui fournit le contenu et la disposition des éléments dans le DataList.
SelectedItemTemplate	Si elle est définie, fournit le contenu et la disposition de l’élément actuellement sélectionné dans le DataList. S’il n’est pas défini, ItemTemplate il est utilisé.
SeparatorTemplate	Si elle est définie, 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 ne s’affiche pas.

Au minimum, il 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 les éléments alternés 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 dans le 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.

Afficher la direction et la disposition

La direction d’affichage d’un DataList contrôle peut être verticale ou horizontale. Définissez la RepeatDirection propriété pour spécifier la direction d’affichage.

La disposition du DataList contrôle est contrôlée avec la RepeatLayout propriété. La définition de cette propriété pour RepeatLayout.Table afficher le DataList format dans un tableau, tandis qu’elle RepeatLayout.Flow affiche le DataList sans structure de tableau.

Sécurité

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

Avertissement

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 l’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, Comment : protéger contre les attaques de script dans une application web en appliquant l’encodage HTML aux chaînes et en validant l’entrée 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

Nom	Description
DataList()	Initialise une nouvelle instance de la classe DataList.

Champs

Nom	Description
CancelCommandName	Représente le nom de la `Cancel` commande. Ce champ est en lecture seule.
DeleteCommandName	Représente le nom de la `Delete` commande. Ce champ est en lecture seule.
EditCommandName	Représente le nom de la `Edit` commande. Ce champ est en lecture seule.
SelectCommandName	Représente le nom de la `Select` commande. Ce champ est en lecture seule.
UpdateCommandName	Représente le nom de la `Update` commande. Ce champ est en lecture seule.

Propriétés

Nom	Description
AccessKey	Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au 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 pour les éléments alternés dans le DataList contrôle.
AlternatingItemTemplate	Obtient ou définit le modèle pour les éléments alternés dans le DataList.
AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control)
Attributes	Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux 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 dans le contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d’appareils technologiques 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 technologiques d’assistance. (Hérité de BaseDataList)
CellPadding	Obtient ou définit la quantité d’espace entre le contenu d’une cellule et la bordure de la cellule. (Hérité de BaseDataList)
CellSpacing	Obtient ou définit la quantité d’espace entre les cellules. (Hérité de BaseDataList)
ChildControlsCreated	Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ClientID	Obtient l’ID de contrôle pour le 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 ClientID propriété. (Hérité de Control)
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control)
Context	Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control)
Controls	Obtient un ControlCollection objet 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 du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ControlStyleCreated	Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
CssClass	Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl)
DataItemContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control)
DataKeyField	Obtient ou définit le champ de clé dans la source de données spécifiée par la DataSource propriété. (Hérité de BaseDataList)
DataKeys	Obtient un DataKeyCollection objet qui stocke les valeurs de clé de chaque enregistrement dans un contrôle de liste de données. (Hérité de BaseDataList)
DataKeysArray	Obtient un ArrayList objet qui contient les valeurs 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’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control)
DataMember	Obtient ou définit le membre de données spécifique dans une source de données multimember pour établir une liaison à 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ées pour remplir les éléments dans le contrôle. (Hérité de BaseDataList)
DataSourceID	Obtient ou définit la ID propriété 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 surface de conception. (Hérité de Control)
EditItemIndex	Obtient ou définit le numéro d’index de l’élément sélectionné dans le DataList contrôle à modifier.
EditItemStyle	Obtient les propriétés de style de l’élément sélectionné pour la modification dans le DataList contrôle.
EditItemTemplate	Obtient ou définit le modèle de l’élément sélectionné pour la modification dans le DataList contrôle.
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 des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
Events	Obtient une liste de délégués de gestionnaire 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 Table contrôle, définies dans chaque modèle d’un DataList contrôle, 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 de la section pied de page du DataList contrôle.
FooterTemplate	Obtient ou définit le modèle pour la section pied de page du DataList contrôle.
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 de ligne de grille du DataList contrôle lorsque la RepeatLayout propriété est définie `RepeatLayout.Table`sur .
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 actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control)
HeaderStyle	Obtient les propriétés de style de la section titre du DataList contrôle.
HeaderTemplate	Obtient ou définit le modèle pour la section titre du DataList contrôle.
Height	Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl)
HorizontalAlign	Obtient ou définit l’alignement horizontal d’un contrôle de liste de données dans son conteneur. (Hérité de BaseDataList)
ID	Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control)
IdSeparator	Obtient le caractère utilisé pour séparer les 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 DataSourceID propriété est définie. (Hérité de BaseDataList)
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de 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 individuels dans le contrôle.
ItemStyle	Obtient les propriétés de style des éléments du DataList contrôle.
ItemTemplate	Obtient ou définit le modèle pour les éléments du DataList contrôle.
LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control)
NamingContainer	Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control)
Page	Obtient une référence à l’instance 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 page. (Hérité de Control)
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control)
RepeatColumns	Obtient ou définit le nombre de colonnes à afficher dans le DataList contrôle.
RepeatDirection	Obtient ou définit si le DataList contrôle s’affiche verticalement ou horizontalement.
RepeatLayout	Obtient ou définit si le contrôle est affiché dans une disposition de table ou de flux.
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 DataSourceSelectArguments objet que le contrôle lié aux données utilise lors de la récupération de données à partir 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 DataList contrôle.
SelectedItem	Obtient l’élément sélectionné dans le DataList contrôle.
SelectedItemStyle	Obtient les propriétés de style de l’élément sélectionné dans le DataList contrôle.
SelectedItemTemplate	Obtient ou définit le modèle de l’élément sélectionné dans le DataList contrôle.
SelectedValue	Obtient la valeur du champ clé de 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 du DataList contrôle.
SeparatorTemplate	Obtient ou définit le modèle pour le séparateur entre les éléments du DataList contrôle.
ShowFooter	Obtient ou définit une valeur indiquant si la section pied de page est affichée dans le DataList contrôle.
ShowHeader	Obtient ou définit une valeur indiquant si la section d’en-tête est affichée dans le DataList contrôle.
Site	Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control)
SkinID	Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl)
Style	Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du 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 sur « disabled » lorsque la propriété du IsEnabled contrôle est `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 DataList contrôle.
TagKey	Obtient la HtmlTextWriterTag valeur qui correspond à ce contrôle de serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
TagName	Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les 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 UserControl ou qui contient le contrôle serveur actuel. (Hérité de Control)
ToolTip	Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl)
UniqueID	Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control)
UseAccessibleHeader	Obtient ou définit une valeur indiquant si le contrôle de liste de données affiche son en-tête dans un format accessible. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d’appareils technologiques d’assistance. (Hérité de BaseDataList)
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des 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 sur plusieurs requêtes pour la même page. (Hérité de Control)
ViewStateIgnoresCase	Obtient une valeur qui indique si l’objet ne respecte pas la StateBag 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

Nom	Description
AddAttributesToRender(HtmlTextWriter)	Ajoute des attributs et des styles HTML qui doivent être rendus dans le fichier spécifié HtmlTextWriterTag. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
AddedControl(Control, Int32)	Appelé après l’ajout d’un contrôle enfant à la Controls collection 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 ajoute l’élément à la collection du ControlCollection contrôle serveur. (Hérité de BaseDataList)
ApplyStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les 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 page au contrôle. (Hérité de Control)
BeginRenderTracing(TextWriter, Object)	Commence le suivi 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 le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control)
ClearCachedClientID()	Définit la valeur mise en ClientID cache sur `null`. (Hérité de Control)
ClearChildControlState()	Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations d’état d’affichage et d’état de contrôle pour 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()	Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (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 les 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 ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control)
CreateControlHierarchy(Boolean)	Crée la hiérarchie de contrôle utilisée pour afficher 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 utilisé en interne par le DataList contrôle pour implémenter toutes les propriétés associées au style.
CreateDataSourceSelectArguments()	Crée un objet par défaut DataSourceSelectArguments 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 de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control)
EndRenderTracing(TextWriter, Object)	Met fin au suivi 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. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control)
EnsureDataBound()	Vérifie que le contrôle de liste de données nécessite une liaison de données et qu’un contrôle de source de données valide est spécifié avant d’appeler la DataBind() méthode. (Hérité de BaseDataList)
EnsureID()	Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindControl(String, Int32)	Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié `id` et spécifié dans le `pathOffset` paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode. (Hérité de Control)
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié `id` . (Hérité de Control)
Focus()	Définit le focus d’entrée sur un contrôle. (Hérité de Control)
GetData()	Retourne un IEnumerableobjet implémenté 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()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l’URL qui correspond à un ensemble 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 ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la UniqueID propriété 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 les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control)
InitializeItem(DataListItem)	Initialise un DataListItem objet en fonction des modèles et styles spécifiés pour le type d’élément de liste.
IsLiteralContent()	Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control)
LoadViewState(Object)	Charge l’état d’affichage précédemment enregistré du DataList contrôle.
MapPathSecure(String)	Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MergeStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page.
OnCancelCommand(DataListCommandEventArgs)	Déclenche l’événement CancelCommand. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement.
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding d’un BaseDataList contrôle. (Hérité de BaseDataList)
OnDataPropertyChanged()	Appelée lorsqu’une des propriétés d’identification de la source de données de base est modifiée, pour rebiner 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é pour l’événement.
OnEditCommand(DataListCommandEventArgs)	Déclenche l’événement EditCommand. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement.
OnInit(EventArgs)	Déclenche l’événement Init pour le DataList contrôle.
OnItemCommand(DataListCommandEventArgs)	Déclenche l’événement ItemCommand. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement.
OnItemCreated(DataListItemEventArgs)	Déclenche l’événement ItemCreated. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement.
OnItemDataBound(DataListItemEventArgs)	Déclenche l’événement ItemDataBound. Cela vous permet de fournir un gestionnaire personnalisé pour 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 BaseDataList contrôle. (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é pour l’événement.
OpenFile(String)	Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control)
PrepareControlHierarchy()	Prépare la hiérarchie de contrôle pour le rendu dans le DataList contrôle.
RaiseBubbleEvent(Object, EventArgs)	Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control)
RemovedControl(Control)	Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control)
Render(HtmlTextWriter)	Restitue le contrôle au writer HTML spécifié. (Hérité de BaseDataList)
RenderBeginTag(HtmlTextWriter)	Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
RenderChildren(HtmlTextWriter)	Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderContents(HtmlTextWriter)	Affiche les éléments de liste dans le DataList contrôle.
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control)
RenderControl(HtmlTextWriter)	Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control)
RenderEndTag(HtmlTextWriter)	Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ResolveAdapter()	Obtient l’adaptateur de contrôle 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 utilisable sur le client demandeur. (Hérité de Control)
SaveControlState()	Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page 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)	Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de 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()	Effectue le suivi des modifications de l’état d’affichage du DataList contrôle afin qu’elles puissent être stockées dans la propriété du ViewState contrôle.

Événements

Nom	Description
CancelCommand	Se produit lorsque le `Cancel` bouton est cliqué pour un élément dans le DataList contrôle.
DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
DeleteCommand	Se produit lorsque le `Delete` bouton est cliqué pour un élément dans le DataList contrôle.
Disposed	Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control)
EditCommand	Se produit lorsque le `Edit` bouton est cliqué pour un élément dans le DataList contrôle.
Init	Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control)
ItemCommand	Se produit lorsqu’un bouton est cliqué dans le DataList contrôle.
ItemCreated	Se produit sur le serveur lorsqu’un élément du DataList contrôle est créé.
ItemDataBound	Se produit lorsqu’un élément est lié aux données liées au DataList contrôle.
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 lorsqu’un autre élément est sélectionné dans un contrôle de liste de données entre les 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 lorsque le `Update` bouton est cliqué pour un élément dans le DataList contrôle.

Implémentations d’interfaces explicites

Nom	Description
IAttributeAccessor.GetAttribute(String)	Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (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

Nom	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type, Object)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type)	Active le comportement des données dynamiques pour le contrôle de données spécifié.
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 de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l’objet métatable pour le contrôle de données contenant.
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, IDictionary<String,Object>)	Définit les métadonnées de table et le mappage de 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 de valeurs par défaut 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é.
TryGetMetaTable(INamingContainer, MetaTable)	Détermine si les métadonnées de table sont disponibles.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?