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

DataList, classe

Un contrôle de liste lié aux données qui affiche les éléments en utilisant des modèles.

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

[ControlValuePropertyAttribute("SelectedValue")] 
public class DataList : BaseDataList, INamingContainer, IRepeatInfoUser
/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser
ControlValuePropertyAttribute("SelectedValue") 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser

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

Le contenu du contrôle DataList 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

S'il est défini, il fournit le contenu et la disposition des éléments de remplacement dans DataList. S'il n'est pas défini, ItemTemplate est utilisé.

EditItemTemplate

S'il est défini, il 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, il fournit le contenu et la disposition du pied de page de DataList. S'il n'est pas défini, un pied de page n'est pas affiché.

HeaderTemplate

S'il est défini, il fournit le contenu et la disposition de l'en-tête de DataList. S'il n'est pas défini, un en-tête n'est pas affiché.

ItemTemplate

Modèle requis qui fournit le contenu et la disposition des éléments dans DataList.

SelectedItemTemplate

S'il est défini, il 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, il fournit le contenu et la disposition du séparateur entre les éléments dans DataList. S'il n'est pas défini, un séparateur n'est pas affiché.

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

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

Propriété de style

Description

AlternatingItemStyle

Spécifie le style des éléments alternés dans le contrôle DataList.

EditItemStyle

Spécifie le style de l'élément en cours de modification dans le contrôle DataList.

FooterStyle

Spécifie le style pour le pied de page dans le contrôle DataList.

HeaderStyle

Spécifie le style pour l'en-tête dans le contrôle DataList.

ItemStyle

Spécifie le style des éléments dans le contrôle DataList.

SelectedItemStyle

Spécifie le style de l'élément sélectionné dans le contrôle DataList.

SeparatorStyle

Spécifie le style pour le séparateur entre les éléments dans le contrôle DataList.

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

Propriété

Description

ShowFooter

Affiche ou masque la section de pied de page du contrôle DataList.

ShowHeader

Affiche ou masque la section d'en-tête du contrôle DataList.

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

La disposition du contrôle DataList est contrôlée par la propriété RepeatLayout. Si vous affectez RepeatLayout.Table à cette propriété, DataList s'affiche au format tableau et RepeatLayout.Flow s'affiche DataList sans structure de tableau.

AttentionAttention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent contenir un script client malveillant. Vérifiez toutes les informations envoyées par un client pour un script exécutable, des instructions SQL ou un autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier l'entrée d'utilisateur avant d'afficher le texte d'entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de la demande d'entrée pour bloquer les scripts et le code HTML dans les entrées d'utilisateur. Pour plus d'informations, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

RubriqueEmplacement
Comment : créer des modèles de contrôle serveur Web ASP.NETGénération d'applications Web ASP.NET
Procédure pas à pas : affichage et mise en forme des données avec le contrôle serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web DataList à une page Web ASP.NET (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création de pages Web maître/détail dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création de pages Web maître/détail dans Visual StudioGénération d'applications à l'aide de Visual Web Developer
Comment : personnaliser de manière dynamique des éléments dans le contrôle serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de supprimer des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET dans Visual Studio
Comment : spécifier une disposition horizontale ou verticale dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage et mise en forme des données avec le contrôle serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de modifier des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser de manière dynamique des éléments dans le contrôle serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de supprimer des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET dans Visual Studio
Comment : spécifier une disposition horizontale ou verticale dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage et mise en forme des données avec le contrôle serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de modifier des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de sélectionner des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web DataList à une page Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des éléments DataList au moment de l'exécutionGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre aux événements de bouton dans des contrôles liés aux donnéesGénération d'applications Web ASP.NET dans Visual Studio
Comment : spécifier le format tabulaire ou de flux dans les contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements de bouton dans des éléments DataList ou RepeaterGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser de manière dynamique des éléments dans le contrôle serveur Web DataListGénération d'applications Web ASP.NET
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET
Comment : permettre aux utilisateurs de supprimer des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET
Comment : ajouter des contrôles DataList à une page Web ASP.NETGénération d'applications Web ASP.NET
Comment : spécifier une disposition horizontale ou verticale dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET
Comment : permettre aux utilisateurs de sélectionner des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET
Comment : répondre à des événements Button dans des éléments des contrôles DataList, Repeater ou GridViewGénération d'applications Web ASP.NET
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : permettre aux utilisateurs de modifier des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET
Comment : personnaliser des éléments DataList au moment de l'exécutionGénération d'applications Web ASP.NET
Comment : répondre aux événements de bouton dans des contrôles liés aux donnéesGénération d'applications Web ASP.NET
Comment : spécifier le format tabulaire ou de flux dans les contrôles serveur Web DataListGénération d'applications Web ASP.NET
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : permettre aux utilisateurs de sélectionner des éléments dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web DataList à une page Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des éléments DataList au moment de l'exécutionGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre aux événements de bouton dans des contrôles liés aux donnéesGénération d'applications Web ASP.NET dans Visual Studio
Comment : spécifier le format tabulaire ou de flux dans les contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements de bouton dans des éléments DataList ou RepeaterGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio

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

RemarqueRemarque

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<html>
   <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>
 
<body>
 
   <form runat=server>

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           ShowBorder="True"
           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"
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

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


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

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

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: