Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

DataList, classe

.NET Framework 4

Autres versions

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

Hiérarchie d'héritage

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataList
        System.Web.UI.WebControls.DataList

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

Syntaxe

C++

Copier

[ControlValuePropertyAttribute("SelectedValue")]
public class DataList : BaseDataList, INamingContainer, 
	IRepeatInfoUser

ASP.NET

Copier

<asp:DataList />

Le type DataList expose les membres suivants.

Constructeurs

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

Début

Propriétés

	Nom	Description
	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	Infrastructure. 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 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 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 System.Web.UI.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 rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande. (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. (Substitue BaseDataList.GridLines.)
	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	Infrastructure. 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é Control.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 affecter à l'attribut disabled de l'élément HTML rendu la valeur "disabled" lorsque 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. (Substitue WebControl.TagKey.)
	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.)
	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 sous la forme d'une 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.)

Début

Méthodes

	Nom	Description
	AddAttributesToRender	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	Appelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.)
	AddParsedSubObject	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	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	Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control.)
	BuildProfileTree	Infrastructure. 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	Infrastructure. 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	Infrastructure. Affecte la valeur Inherit à la propriété ClientIDMode de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control.)
	CopyBaseAttributes	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	Infrastructure. Crée un contrôle enfant à l'aide de l'état d'affichage. (Hérité de BaseDataList.)
	CreateControlCollection	Crée un nouvel objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control.)
	CreateControlHierarchy	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. (Substitue BaseDataList.CreateControlHierarchy(Boolean).)
	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. (Substitue WebControl.CreateControlStyle().)
	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	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.)
	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'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (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)	Infrastructure. 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	Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (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	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	Initialise un objet DataListItem en fonction des modèles et des styles spécifiés pour le type d'élément de liste.
	IsLiteralContent	Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
	LoadControlState	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	Charge l'état d'affichage précédemment enregistré du contrôle DataList. (Substitue WebControl.LoadViewState(Object).)
	MapPathSecure	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 de l'objet Object actif. (Hérité de Object.)
	MergeStyle	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	Détermine si l'événement pour le contrôle serveur est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Substitue Control.OnBubbleEvent(Object, EventArgs).)
	OnCancelCommand	Déclenche l'événement CancelCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
	OnDataBinding	Infrastructure. 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	Déclenche l'événement DataSourceViewChanged. (Hérité de BaseDataList.)
	OnDeleteCommand	Déclenche l'événement DeleteCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
	OnEditCommand	Déclenche l'événement EditCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
	OnInit	Déclenche l'événement Init pour le contrôle DataList. (Substitue BaseDataList.OnInit(EventArgs).)
	OnItemCommand	Déclenche l'événement ItemCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
	OnItemCreated	Déclenche l'événement ItemCreated. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
	OnItemDataBound	Déclenche l'événement ItemDataBound. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
	OnLoad	Infrastructure. Déclenche l'événement Load. (Hérité de BaseDataList.)
	OnPreRender	Infrastructure. Déclenche l'événement PreRender. (Hérité de BaseDataList.)
	OnSelectedIndexChanged	Déclenche l'événement SelectedIndexChanged d'un contrôle BaseDataList. (Hérité de BaseDataList.)
	OnUnload	Déclenche l'événement Unload. (Hérité de Control.)
	OnUpdateCommand	Déclenche l'événement UpdateCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
	OpenFile	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. (Substitue BaseDataList.PrepareControlHierarchy().)
	RaiseBubbleEvent	Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
	RemovedControl	Appelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.)
	Render	Infrastructure. Génère le rendu du contrôle via le writer HTML spécifié. (Hérité de BaseDataList.)
	RenderBeginTag	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	Renvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.)
	RenderContents	Génère le rendu des éléments de liste dans le contrôle DataList. (Substitue WebControl.RenderContents(HtmlTextWriter).)
	RenderControl(HtmlTextWriter)	Renvoie le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du 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	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	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
	ResolveUrl	Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
	SaveControlState	Enregistre les modifications éventuellement apportées à l'état du contrôle serveur 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. (Substitue WebControl.SaveViewState().)
	SetDesignModeState	Définit les données au moment du design pour un contrôle. (Hérité de Control.)
	SetRenderMethodDelegate	Infrastructure. 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.)
	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. (Substitue WebControl.TrackViewState().)

Début

Événements

	Nom	Description
	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.

Début

Méthodes d'extension

	Nom	Description
	EnableDynamicData(Type)	Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
	EnableDynamicData(Type, Object)	Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
	EnableDynamicData(Type, IDictionary<String, Object>)	Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
	FindDataSourceControl	Retourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.)
	FindFieldTemplate	Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.)
	FindMetaTable	Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
	GetDefaultValues	Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
	GetMetaTable	Obtient les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
	SetMetaTable(MetaTable)	Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
	SetMetaTable(MetaTable, IDictionary<String, Object>)	Surchargé. 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é. (Défini par DynamicDataExtensions.)
	SetMetaTable(MetaTable, Object)	Surchargé. 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é. (Défini par DynamicDataExtensions.)
	TryGetMetaTable	Détermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.)

Début

Champs

	Nom	Description
	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.

Début

Implémentations d'interface explicite

Début

Notes

Dans cette rubrique :

Introduction
Modèles
Personnalisation de l'apparence du contrôle DataList
Afficher la direction et la disposition
Sécurité
Syntaxe déclarative

Introduction

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.

Modèles

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.

Personnalisation de l'apparence du 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 de remplacement 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.

Afficher la direction et la disposition

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.

Sécurité

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

Attention
Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client nuisible. Recherchez dans toutes les informations envoyées par un client un script exécutable, des instructions SQL ou d'autre code avant de les afficher dans votre application. Vous pouvez utiliser les contrôles de validation pour vérifier les entrées d'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 les scripts et le HTML dans les entrées d'utilisateur (user input).

Attention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client nuisible. Recherchez dans toutes les informations envoyées par un client un script exécutable, des instructions SQL ou d'autre code avant de les afficher dans votre application. Vous pouvez utiliser les contrôles de validation pour vérifier les entrées d'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 les scripts et le HTML dans les entrées d'utilisateur (user input).

Pour plus d'informations sur la sécurité, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant l'encodage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

Syntaxe déclarative

Copier

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

Exemples

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.

Remarque
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 des Web Forms, consultez Modèle de code des pages Web ASP.NET.

Copier



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

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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

Sécurité des threads

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

Voir aussi

Référence

System.Web.UI.WebControls, espace de noms

BaseDataList

DataGrid

Repeater

Autres ressources

Vue d'ensemble du contrôle serveur Web DataList

Sécurisation de contrôles standard

Comment : se protéger contre les attaques de script dans une application Web en utilisant l'encodage HTML

Validation des entrées d'utilisateur dans des pages Web ASP.NET

Modèle de code des pages Web ASP.NET

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Contenu de la communauté Ajouter

FAQ

	Nom	Description
	IAttributeAccessor.GetAttribute	Infrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
	IAttributeAccessor.SetAttribute	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 IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
	IControlDesignerAccessor.GetDesignModeState	Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
	IControlDesignerAccessor.SetDesignModeState	Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
	IControlDesignerAccessor.SetOwnerControl	Infrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
	IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
	IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
	IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
	IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
	IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
	IParserAccessor.AddParsedSubObject	Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
	IRepeatInfoUser.GetItemStyle	Infrastructure. Pour obtenir une description de ce membre, consultez IRepeatInfoUser.GetItemStyle.
	IRepeatInfoUser.HasFooter	Infrastructure. Pour obtenir une description de ce membre, consultez IRepeatInfoUser.HasFooter.
	IRepeatInfoUser.HasHeader	Infrastructure. Pour obtenir une description de ce membre, consultez IRepeatInfoUser.HasHeader.
	IRepeatInfoUser.HasSeparators	Infrastructure. Pour obtenir une description de ce membre, consultez IRepeatInfoUser.HasSeparators.
	IRepeatInfoUser.RenderItem	Infrastructure. Pour obtenir une description de ce membre, consultez IRepeatInfoUser.RenderItem.
	IRepeatInfoUser.RepeatedItemCount	Infrastructure. Pour obtenir une description de ce membre, consultez IRepeatInfoUser.RepeatedItemCount.