Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
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

DataGrid, classe

.NET Framework 4

Contrôle de liste lié aux données qui affiche les éléments provenant de la source de données dans un tableau. Le contrôle DataGrid vous permet de sélectionner, trier et modifier ces éléments.

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

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public class DataGrid : BaseDataList, INamingContainer
ASP.NET
Copier 
<asp:DataGrid />

Le type DataGrid expose les membres suivants.

  Nom Description
Méthode publique DataGrid Initialise une nouvelle instance de la classe DataGrid.
Début
  Nom Description
Propriété publique 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.)
Propriété protégée Adapter Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publique AllowCustomPaging Obtient ou définit une valeur indiquant si la pagination personnalisée est activée.
Propriété publique AllowPaging Obtient ou définit une valeur indiquant si la pagination est activée.
Propriété publique AllowSorting Obtient ou définit une valeur indiquant si le tri est activé.
Propriété publique AlternatingItemStyle Obtient les propriétés de style des éléments de remplacement dans le contrôle DataGrid.
Propriété publique 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.)
Propriété publique 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.)
Propriété publique AutoGenerateColumns Obtient ou définit une valeur indiquant si les objets BoundColumn sont automatiquement créés et affichés dans le contrôle DataGrid pour chaque champ de la source de données.
Propriété publique BackColor Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BackImageUrl Obtient ou définit l'URL d'une image à afficher à l'arrière-plan du contrôle DataGrid.
Propriété publique BindingContainer Infrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publique BorderColor Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publique BorderStyle Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique BorderWidth Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique CellPadding Obtient ou définit l'espace entre le contenu d'une cellule et la bordure de celle-ci. (Hérité de BaseDataList.)
Propriété publique CellSpacing Obtient ou définit l'espace entre les cellules. (Hérité de BaseDataList.)
Propriété protégée ChildControlsCreated Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publique ClientID Obtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.)
Propriété publique ClientIDMode Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.)
Propriété protégée 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.)
Propriété publique Columns Obtient une collection d'objets représentant les colonnes du contrôle DataGrid.
Propriété protégée Context Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique CurrentPageIndex Obtient ou définit l'index de la page actuellement affichée.
Propriété publique DataItemContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publique 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.)
Propriété publique 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.)
Propriété protégée 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.)
Propriété publique DataKeysContainer Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique 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.)
Propriété protégée DesignMode Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publique EditItemIndex Obtient ou définit l'index d'un élément du contrôle DataGrid à modifier.
Propriété publique EditItemStyle Obtient les propriétés de style de l'élément sélectionné pour être modifié dans le contrôle DataGrid.
Propriété publique Enabled Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publique EnableTheming Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publique 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.)
Propriété protégée 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.)
Propriété publique Font Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publique FooterStyle Obtient les propriétés de style de la section de pied de page dans le contrôle DataGrid.
Propriété publique 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.)
Propriété publique GridLines Obtient ou définit une valeur qui spécifie si la bordure entre les cellules d'un contrôle de liste de données est affichée. (Hérité de BaseDataList.)
Propriété publique HasAttributes Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégée 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.)
Propriété publique HeaderStyle Obtient les propriétés de style de la section d'en-tête dans le contrôle DataGrid.
Propriété publique Height Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publique HorizontalAlign Obtient ou définit l'alignement horizontal du contrôle de liste de données dans son conteneur. (Hérité de BaseDataList.)
Propriété publique ID Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégée IdSeparator Infrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégée Initialized Obtient une valeur indiquant si le contrôle a été initialisé. (Hérité de BaseDataList.)
Propriété protégée IsBoundUsingDataSourceID Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataList.)
Propriété protégée IsChildControlStateCleared Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.)
Propriété protégée IsEnabled Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégée IsTrackingViewState Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
Propriété protégée IsViewStateEnabled Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété publique Items Obtient une collection d'objets DataGridItem représentant les éléments individuels du contrôle DataGrid.
Propriété publique ItemStyle Obtient les propriétés de style des éléments figurant dans le contrôle DataGrid.
Propriété protégée 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.)
Propriété publique 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.)
Propriété publique Page Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publique PageCount Obtient le nombre total de pages requises pour afficher les éléments figurant dans le contrôle DataGrid.
Propriété publique PagerStyle Obtient les propriétés de style de la section de pagination du contrôle DataGrid.
Propriété publique PageSize Obtient ou définit le nombre d'éléments à afficher sur une même page du contrôle DataGrid.
Propriété publique 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.)
Propriété publique RenderingCompatibility Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété protégée 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.)
Propriété protégée 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.)
Propriété publique SelectedIndex Obtient ou définit l'index de l'élément sélectionné dans le contrôle DataGrid.
Propriété publique SelectedItem Obtient un objet DataGridItem représentant l'élément sélectionné dans le contrôle DataGrid.
Propriété publique SelectedItemStyle Obtient les propriétés de style de l'élément actuellement sélectionné dans le contrôle DataGrid.
Propriété publique ShowFooter Obtient ou définit une valeur qui indique si le pied de page est affiché dans le contrôle DataGrid.
Propriété publique ShowHeader Obtient ou définit une valeur qui indique si l'en-tête est affiché dans le contrôle DataGrid.
Propriété publique 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.)
Propriété publique SkinID Obtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publique 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.)
Propriété publique 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.)
Propriété publique TabIndex Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégée TagKey Obtient la valeur HtmlTextWriterTag du contrôle DataGrid. (Substitue WebControl.TagKey.)
Propriété protégée 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.)
Propriété publique TemplateControl Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publique TemplateSourceDirectory Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publique 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.)
Propriété publique UniqueID Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
Propriété publique 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.)
Propriété protégée 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.)
Propriété protégée ViewStateIgnoresCase Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
Propriété publique ViewStateMode Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publique VirtualItemCount Obtient ou définit le nombre virtuel d'éléments dans le contrôle DataGrid lorsque la pagination personnalisée est utilisée.
Propriété publique 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.)
Propriété publique Width Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début
  Nom Description
Méthode protégée 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.)
Méthode protégée AddedControl Appelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode protégée ClearCachedClientID Infrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégée ClearChildControlState Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée 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.)
Méthode protégée ClearChildViewState Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode protégée CreateChildControls Infrastructure. Crée un contrôle enfant à l'aide de l'état d'affichage. (Hérité de BaseDataList.)
Méthode protégée CreateColumnSet Crée l'ensemble des colonnes à utiliser pour développer la hiérarchie des contrôles. Lorsque AutoGenerateColumns a la valeur true, les colonnes sont créées afin de correspondre à la source de données et sont ajoutées à l'ensemble des colonnes défini dans la collection Columns.
Méthode protégée 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.)
Méthode protégée CreateControlHierarchy Crée la hiérarchie des contrôles utilisée pour afficher le DataGrid. (Substitue BaseDataList.CreateControlHierarchy(Boolean).)
Méthode protégée CreateControlStyle Crée un nouveau style de contrôle. (Substitue WebControl.CreateControlStyle().)
Méthode protégée 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.)
Méthode protégée CreateItem Crée un objet DataGridItem.
Méthode publique DataBind() Lie le contrôle et tous ses contrôles enfants à la source de données spécifiée. (Hérité de BaseDataList.)
Méthode protégée 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.)
Méthode protégée DataBindChildren Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode protégée 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.)
Méthode protégée EnsureID Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode publique Focus Affecte le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégée GetData Retourne un objet implémentant IEnumerable qui représente la source de données. (Hérité de BaseDataList.)
Méthode protégée GetDesignModeState Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetRouteUrl(Object) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique GetRouteUrl(RouteValueDictionary) Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique GetUniqueIDRelativeTo Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publique HasControls Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégée HasEvents Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégée InitializeItem Initialise l'objet DataGridItem spécifié.
Méthode protégée InitializePager Crée un objet DataGridItem qui contient l'interface utilisateur de pagination.
Méthode protégée IsLiteralContent Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégée 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.)
Méthode protégée LoadViewState Charge un état enregistré du DataGrid. (Substitue WebControl.LoadViewState(Object).)
Méthode protégée 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.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique 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.)
Méthode protégée OnBubbleEvent Passe l'événement déclenché par un contrôle dans le conteneur en haut de la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Substitue Control.OnBubbleEvent(Object, EventArgs).)
Méthode protégée OnCancelCommand Déclenche l'événement CancelCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnDataBinding Infrastructure. Déclenche l'événement DataBinding d'un contrôle BaseDataList. (Hérité de BaseDataList.)
Méthode protégée 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.)
Méthode protégée OnDataSourceViewChanged Déclenche l'événement DataSourceViewChanged. (Hérité de BaseDataList.)
Méthode protégée OnDeleteCommand Déclenche l'événement DeleteCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnEditCommand Déclenche l'événement EditCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnInit Infrastructure. Déclenche l'événement Init pour le contrôle BaseDataList. (Hérité de BaseDataList.)
Méthode protégée OnItemCommand Déclenche l'événement ItemCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnItemCreated Déclenche l'événement ItemCreated. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnItemDataBound Déclenche l'événement ItemDataBound. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnLoad Infrastructure. Déclenche l'événement Load. (Hérité de BaseDataList.)
Méthode protégée OnPageIndexChanged Déclenche l'événement PageIndexChanged. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnPreRender Infrastructure. Déclenche l'événement PreRender. (Hérité de BaseDataList.)
Méthode protégée OnSelectedIndexChanged Déclenche l'événement SelectedIndexChanged d'un contrôle BaseDataList. (Hérité de BaseDataList.)
Méthode protégée OnSortCommand Déclenche l'événement SortCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OnUnload Déclenche l'événement Unload. (Hérité de Control.)
Méthode protégée OnUpdateCommand Déclenche l'événement UpdateCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
Méthode protégée OpenFile Obtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégée PrepareControlHierarchy Infrastructure. Définit la hiérarchie des contrôles pour ce contrôle DataGrid. (Substitue BaseDataList.PrepareControlHierarchy().)
Méthode protégée RaiseBubbleEvent Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégée RemovedControl Appelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.)
Méthode protégée Render Infrastructure. Génère le rendu du contrôle via le writer HTML spécifié. (Hérité de BaseDataList.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode protégée RenderContents Génère le rendu du contenu 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.)
Méthode publique 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.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode protégée ResolveAdapter Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publique ResolveClientUrl Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publique ResolveUrl Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégée 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.)
Méthode protégée SaveViewState Enregistre l'état actuel de DataGrid. (Substitue WebControl.SaveViewState().)
Méthode protégée SetDesignModeState Définit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publique 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.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégée TrackViewState Marque le point de départ du suivi et de l'enregistrement des modifications apportées au contrôle dans le cadre de la gestion de l'état d'affichage du contrôle. (Substitue WebControl.TrackViewState().)
Début
  Nom Description
Événement public CancelCommand Se produit lorsqu'un clic est effectué sur le bouton Cancel pour un élément dans le contrôle DataGrid.
Événement public DataBinding Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement public DeleteCommand Se produit lorsqu'un clic est effectué sur le bouton Supprimer pour un élément dans le contrôle DataGrid.
Événement public 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.)
Événement public EditCommand Se produit lorsqu'un clic est effectué sur le bouton Modifier pour un élément dans le contrôle DataGrid.
Événement public 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.)
Événement public ItemCommand Se produit lorsqu'un clic est effectué sur n'importe quel bouton dans le contrôle DataGrid.
Événement public ItemCreated Se produit sur le serveur lors de la création d'un élément dans le contrôle DataGrid.
Événement public ItemDataBound Se produit après la liaison d'un élément aux données du contrôle DataGrid.
Événement public Load Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement public PageIndexChanged Se produit après un clic sur l'un des éléments de sélection de page.
Événement public PreRender Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
Événement public 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.)
Événement public SortCommand Se produit lorsqu'une colonne est triée.
Événement public Unload Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Événement public UpdateCommand Se produit lorsqu'un clic est effectué sur le bouton Mettre à jour pour un élément dans le contrôle DataGrid.
Début
  Nom Description
Méthode d'extension publique EnableDynamicData(Type) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique EnableDynamicData(Type, Object) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique EnableDynamicData(Type, IDictionary<String, Object>) Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié. (Défini par DataControlExtensions.)
Méthode d'extension publique 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.)
Méthode d'extension publique 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.)
Méthode d'extension publique FindMetaTable Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Méthode d'extension publique GetDefaultValues Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique GetMetaTable Obtient les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique SetMetaTable(MetaTable) Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publique 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.)
Méthode d'extension publique 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.)
Méthode d'extension publique TryGetMetaTable Détermine si des métadonnées de table sont disponibles. (Défini par DynamicDataExtensions.)
Début
  Nom Description
Champ public Membre statique CancelCommandName Représente le nom de la commande Cancel. Ce champ est en lecture seule.
Champ public Membre statique DeleteCommandName Représente le nom de la commande Delete. Ce champ est en lecture seule.
Champ public Membre statique EditCommandName Représente le nom de la commande Edit. Ce champ est en lecture seule.
Champ public Membre statique NextPageCommandArgument Représente l'argument de la commande Next. Ce champ est en lecture seule.
Champ public Membre statique PageCommandName Représente le nom de la commande Page. Ce champ est en lecture seule.
Champ public Membre statique PrevPageCommandArgument Représente l'argument de la commande Prev. Ce champ est en lecture seule.
Champ public Membre statique SelectCommandName Représente le nom de la commande Select. Ce champ est en lecture seule.
Champ public Membre statique SortCommandName Représente le nom de la commande Sort. Ce champ est en lecture seule.
Champ public Membre statique UpdateCommandName Représente le nom de la commande Update. Ce champ est en lecture seule.
Début
  Nom Description
Implémentation d'interface explicite Méthode privée IAttributeAccessor.GetAttribute Infrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface explicite Méthode privée IAttributeAccessor.SetAttribute Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface explicite Propriété privée IControlBuilderAccessor.ControlBuilder Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.GetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetDesignModeState Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IControlDesignerAccessor.SetOwnerControl Infrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IControlDesignerAccessor.UserData Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.DataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IDataBindingsAccessor.HasDataBindings Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.Expressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicite Propriété privée IExpressionsAccessor.HasExpressions Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface explicite Méthode privée IParserAccessor.AddParsedSubObject Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Début

Dans cette rubrique :

Introduction

Utilisez le contrôle DataGrid pour afficher les champs d'une source de données sous forme de colonnes dans un tableau. Chaque ligne du contrôle DataGrid représente un enregistrement de la source de données. Le contrôle DataGrid prend en charge la sélection, la modification, la suppression, la pagination et le tri.

Remarque Attention 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. 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). Des contrôles serveur de validation sont également fournis pour valider les entrées d'utilisateur (user input). Pour plus d'informations, consultez Syntaxe des contrôles serveur de validation.

Différents types de colonnes déterminent le comportement des colonnes dans le contrôle. Le tableau suivant affiche les différents types de colonnes qui peuvent être utilisés.

Type de colonne

Description

BoundColumn

Affiche une colonne liée à un champ dans une source de données. Elle affiche chaque élément figurant dans le champ sous forme de texte. Il s'agit du type de colonne par défaut du contrôle DataGrid.

ButtonColumn

Affiche un bouton de commande pour chaque élément dans la colonne. Cela vous permet de créer une colonne de contrôles boutons personnalisés, tels que les boutons Add ou Remove.

EditCommandColumn

Affiche une colonne qui contient des commandes de modification pour chaque élément dans la colonne.

HyperLinkColumn

Affiche le contenu de chaque élément dans la colonne sous forme de lien hypertexte. Le contenu de la colonne peut être lié à un champ dans une source de données ou à du texte statique.

TemplateColumn

Affiche chaque élément dans la colonne suivant un modèle spécifié. Cela vous permet de fournir des contrôles personnalisés dans la colonne.

Par défaut, la propriété AutoGenerateColumns a la valeur true, qui crée un objet BoundColumn pour chaque champ dans la source de données. Chaque champ est ensuite rendu sous forme de colonne dans le contrôle DataGrid dans l'ordre dans lequel chaque champ s'affiche dans la source de données.

Vous pouvez également contrôler manuellement les colonnes qui s'affichent dans le contrôle DataGrid en affectant false à la propriété AutoGenerateColumns, puis en répertoriant les colonnes que vous souhaitez inclure entre les balises <Columns> d'ouverture et de fermeture. Les colonnes spécifiées sont ajoutées à la collection Columns dans l'ordre répertorié. Cela vous permet de contrôler les colonnes du contrôle DataGrid par programme.

Remarque Remarque

L'ordre dans lequel les colonnes sont affichées dans le contrôle DataGrid est contrôlé par l'ordre dans lequel les colonnes s'affichent dans la collection Columns. Bien que vous puissiez changer l'ordre des colonnes par programme en manipulant la collection Columns, il est plus simple d'afficher les colonnes dans l'ordre d'affichage souhaité.

Les colonnes déclarées explicitement peuvent être affichées conjointement avec des colonnes générées automatiquement. Lorsque vous utilisez les deux types de colonnes, les colonnes déclarées explicitement sont rendues les premières, suivies des colonnes générées automatiquement.

Remarque Remarque

Les colonnes générées automatiquement ne sont pas ajoutées à la collection Columns.

L'apparence du contrôle DataGrid 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 DataGrid.

EditItemStyle

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

FooterStyle

Spécifie le style de la section de pied de page dans le contrôle DataGrid.

HeaderStyle

Spécifie le style de la section d'en-tête dans le contrôle DataGrid.

ItemStyle

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

PagerStyle

Spécifie le style de la section de sélection de page du contrôle DataGrid.

SelectedItemStyle

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

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

ShowHeader

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

Vous pouvez contrôler l'aspect du contrôle DataGrid en ajoutant des attributs par programme aux balises <td> et <tr> rendues par le contrôle sur le navigateur. Des attributs peuvent être ajoutés par programme en fournissant du code dans le gestionnaire d'événements pour OnItemCreated ou OnItemDataBound.

Pour ajouter un attribut à la balise <td>, vous devez obtenir l'objet TableCell qui représente la cellule dans le contrôle DataGrid auquel vous souhaitez ajouter l'attribut. La collection Control.Controls pour la propriété Item de l'objet DataGridItemEventArgs passée au gestionnaire d'événements peut être utilisée pour obtenir l'objet TableCell souhaité. Vous pouvez ensuite utiliser la méthode AttributeCollection.Add de la collection Attributes pour l'objet TableCell afin d' ajouter des attributs à la balise <td>.

Pour ajouter un attribut à la balise <tr>, vous devez obtenir l'objet DataGridItem qui représente la ligne dans le contrôle DataGrid auquel vous souhaitez ajouter l'attribut. La propriété Item de l'objet DataGridItemEventArgs passée au gestionnaire d'événements peut être utilisée pour obtenir l'objet DataGridItem souhaité. Vous pouvez ensuite utiliser la méthode AttributeCollection.Add de la collection Attributes pour l'objet DataGridItem afin d'ajouter des attributs à la balise <tr>.

Accessibilité

Pour plus d'informations sur la configuration de ce contrôle afin qu'il génère des balises conforment aux standards d'accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et Contrôles et accessibilité ASP.NET.

Syntaxe déclarative

Copier 
<asp:DataGrid
    AccessKey="string"
    AllowCustomPaging="True|False"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    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"
    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"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSortCommand="SortCommand event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    PageSize="integer"
    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 />
        <Columns>
                <asp:BoundColumn
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ReadOnly="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundColumn>
                <asp:ButtonColumn
                    ButtonType="LinkButton|PushButton"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonColumn>
                <asp:EditCommandColumn
                    ButtonType="LinkButton|PushButton"
                    CancelText="string"
                    CausesValidation="True|False"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:EditCommandColumn>
                <asp:HyperLinkColumn
                    DataNavigateUrlField="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    NavigateUrl="uri"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkColumn>
                <asp:TemplateColumn
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Visible="True|False"
>
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateColumn>
        </Columns>
        <EditItemStyle />
        <FooterStyle />
        <HeaderStyle />
        <ItemStyle />
        <PagerStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            CssClass="string"
            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"
            Height="size"
            HorizontalAlign="NotSet|Left|Center|Right|Justify"
            Mode="NextPrev|NumericPages"
            NextPageText="string"
            OnDisposed="Disposed event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PrevPageText="string"
            VerticalAlign="NotSet|Top|Middle|Bottom"
            Visible="True|False"
            Width="size"
            Wrap="True|False"
        />
        <SelectedItemStyle />
</asp:DataGrid>

Un projet de site Web Visual Studio contenant du code source accompagne cette rubrique : Télécharger.

L'exemple de code suivant montre comment utiliser la propriété DataGrid pour afficher des éléments dans la source de données.

C#
VB
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 language="C#" runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {

         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }

   </script>

<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataGrid Example</h3>

      <b>Product List</b>

      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 

      </asp:DataGrid>

   </form>

</body>
</html>

L'exemple de code suivant montre comment utiliser le contrôle DataGrid pour un panier d'achat simple.

C#
VB
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 language="C#" runat="server">

      DataTable Cart;
      DataView CartView;

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {

         if (Session["DG4_ShoppingCart"] == null) 
         {
            Cart = new DataTable();
            Cart.Columns.Add(new DataColumn("Item", typeof(string)));
            Cart.Columns.Add(new DataColumn("Price", typeof(string)));
            Session["DG4_ShoppingCart"] = Cart;
         }

         else 
         {
            Cart = (DataTable)Session["DG4_ShoppingCart"];
         }    

         CartView = new DataView(Cart);
         ShoppingCart.DataSource = CartView;
         ShoppingCart.DataBind();

         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }

      void Grid_CartCommand(Object sender, DataGridCommandEventArgs e) 
      {

         DataRow dr = Cart.NewRow();

         // e.Item is the table row where the command is raised.
         // For bound columns, the value is stored in the Text property of the TableCell.
         TableCell itemCell = e.Item.Cells[2];
         TableCell priceCell = e.Item.Cells[3];
         string item = itemCell.Text;
         string price = priceCell.Text;

         if (((Button)e.CommandSource).CommandName == "AddToCart") 
         {
            dr[0] = item;
            dr[1] = price;
            Cart.Rows.Add(dr);
         }

         else 
         {  

            // Remove from Cart.

            CartView.RowFilter = "Item='" + item + "'";
            if (CartView.Count > 0) 
            {     
               CartView.Delete(0);
            }
            CartView.RowFilter = "";
         }

         ShoppingCart.DataBind();

      }


   </script>

<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>

   <form id="form1" runat="server">

   <h3>DataGrid Example</h3>

   <table cellpadding="5">
      <tr valign="top">
         <td>

            <b>Product List</b>

            <asp:DataGrid id="ItemsGrid"
                 BorderColor="black"
                 BorderWidth="1"
                 CellPadding="3"
                 AutoGenerateColumns="false"
                 OnItemCommand="Grid_CartCommand"
                 runat="server">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

               <Columns>

                  <asp:ButtonColumn 
                       HeaderText="Add to cart" 
                       ButtonType="PushButton" 
                       Text="Add" 
                       CommandName="AddToCart" />

                  <asp:ButtonColumn 
                       HeaderText="Remove from cart" 
                       ButtonType="PushButton" 
                       Text="Remove" 
                       CommandName="RemoveFromCart" />

                  <asp:BoundColumn 
                       HeaderText="Item" 
                       DataField="StringValue"/>

                  <asp:BoundColumn 
                       HeaderText="Price" 
                       DataField="CurrencyValue" 
                       DataFormatString="{0:c}">

                     <ItemStyle HorizontalAlign="right">
                     </ItemStyle>

                  </asp:BoundColumn>   

               </Columns>

            </asp:DataGrid>

         </td>
         <td>

            <b>Shopping Cart</b>

            <asp:DataGrid id="ShoppingCart" 
                 runat="server"
                 BorderColor="black"
                 BorderWidth="1"
                 GridLines="Both"
                 ShowFooter="false"
                 CellPadding="3"
                 CellSpacing="0">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

            </asp:DataGrid> 

         </td>
      </tr>

   </table>

   </form>

</body>
</html>

L'exemple de code suivant montre comment ajouter dynamiquement des attributs aux balises <td> et <tr> générées par le contrôle DataGrid.

C#
VB
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() 
   {
      DataTable dt = new DataTable();
      DataRow dr;

      dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
      dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
      dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

      for (int i = 0; i < 5; i++) 
      {
         dr = dt.NewRow();

         dr[0] = i;
         dr[1] = "Item " + i.ToString();
         dr[2] = 1.23 * (i+1);

         dt.Rows.Add(dr);
      }

      DataView dv = new DataView(dt);
      return dv;
   }

   void Page_Load(Object sender, EventArgs e) 
   {

      if (!IsPostBack) 
      {
         // Load this data only once.
         ItemsGrid.DataSource = CreateDataSource();
         ItemsGrid.DataBind();
      }

   }

   void Item_Bound(Object sender, DataGridItemEventArgs e) 
   {

      ListItemType itemType = (ListItemType)e.Item.ItemType;

      if ((itemType != ListItemType.Header) &&
          (itemType != ListItemType.Footer) &&
          (itemType != ListItemType.Separator))
      {

         // Get the IntegerValue cell from the grid's column collection.
         TableCell intCell = (TableCell)e.Item.Controls[0];

         // Add attributes to the cell.
         intCell.Attributes.Add("id", "intCell" + e.Item.ItemIndex.ToString());
         intCell.Attributes.Add("OnClick", 
                                "Update_intCell" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");

         // Add attributes to the row.
         e.Item.Attributes.Add("id", "row" + e.Item.ItemIndex.ToString());
         e.Item.Attributes.Add("OnDblClick", 
                                "Update_row" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");

      }

   }

</script>

<script type="text/vbscript">

   sub Update_intCell0 
      Alert "You Selected Cell 0."
   end sub

   sub Update_intCell1 
      Alert "You Selected Cell 1."
   end sub

   sub Update_intCell2 
      Alert "You Selected Cell 2."
   end sub

   sub Update_intCell3 
      Alert "You Selected Cell 3."
   end sub

   sub Update_intCell4 
      Alert "You Selected Cell 4."
   end sub

   sub UpDate_row0 
      Alert "You selected the row 0."
   end sub

   sub UpDate_row1 
      Alert "You selected the row 1."
   end sub

   sub UpDate_row2 
      Alert "You selected the row 2."
   end sub

   sub UpDate_row3 
      Alert "You selected the row 3."
   end sub

   sub UpDate_row4 
      Alert "You selected the row 4."
   end sub   

</script>

<head runat="server">
    <title>
            Adding Attributes to the &lt;td&gt; and &lt;tr&gt; </title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>
            Adding Attributes to the &lt;td&gt; and &lt;tr&gt; <br />
            Tags of a DataGrid Control
      </h3>

      <asp:DataGrid id="ItemsGrid" runat="server"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           ShowFooter="true"
           OnItemDataBound="Item_Bound"
           AutoGenerateColumns="false">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <FooterStyle BackColor="#00aaaa">
         </FooterStyle>

         <Columns>

            <asp:BoundColumn HeaderText="Number" 
                 DataField="IntegerValue">

               <ItemStyle BackColor="yellow">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Item" 
                 DataField="StringValue"/>

            <asp:BoundColumn 
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="right">
               </ItemStyle>

            </asp:BoundColumn>

         </Columns>

      </asp:DataGrid>

      <br /><br />

      Click on one of the cells in the <b>Number</b> column to select the cell.

      <br /><br />

      Double click on a row to select a row.   

   </form>

</body>
</html>
C#
VB
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 DataGrid 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)));

         // Populate the table with sample values.for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            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) 
         {
            ItemsGrid.DataSource = CreateDataSource();
            ItemsGrid.DataBind();
         }

      }

      void Button_Click(Object sender, EventArgs e) 
      {

         // Count the number of selected items in the DataGrid control.int count = 0;

         // Display the selected times.
         Message.Text = "You Selected: <br />";

         // Iterate through each item (row) in the DataGrid control and // determine whether it is selected.foreach (DataGridItem item in ItemsGrid.Items)
         {

            DetermineSelection(item, ref count);        

         }

         // If no items are selected, display the appropriate message.if (count == 0)
         {

            Message.Text = "No items selected";

         }

      }

      void DetermineSelection(DataGridItem item, refint count)
      {

         // Retrieve the SelectCheckBox CheckBox control from the specified // item (row) in the DataGrid control.
         CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox");

         // If the item is selected, display the appropriate message and // increment the count of selected items.if (selection != null)
         {

           if (selection.Checked)
           {
              Message.Text += "- " + item.Cells[1].Text + "<br />";
              count++;
           }

         }    

      }

   </script>

<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataGrid Example</h3>

      <b>Product List</b>

      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="False"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn DataField="IntegerValue" 
                 HeaderText="Item"/>

            <asp:BoundColumn DataField="StringValue" 
                 HeaderText="Description"/>

            <asp:BoundColumn DataField="CurrencyValue" 
                 HeaderText="Price"
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="Right">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:TemplateColumn HeaderText="Select Item">

               <ItemTemplate>

                  <asp:CheckBox id="SelectCheckBox"
                       Text="Add to Cart"
                       Checked="False"
                       runat="server"/>

               </ItemTemplate>

            </asp:TemplateColumn>

         </Columns> 

      </asp:DataGrid>

      <br /><br />

      <asp:Button id="SubmitButton"
           Text="Submit"
           OnClick = "Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label id="Message"
           runat="server"/>

   </form>

</body>
</html>

.NET Framework

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

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.
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.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ