Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

GridView, classe

Affiche les valeurs d'une source de données dans une table où chaque colonne représente un champ et chaque ligne représente un enregistrement. Le contrôle GridView vous permet de sélectionner, trier et modifier ces éléments.

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

[ControlValuePropertyAttribute("SelectedValue")]
public class GridView : CompositeDataBoundControl, IPostBackContainer, 
	IPostBackEventHandler, ICallbackContainer, ICallbackEventHandler, IPersistedSelector, IDataKeysControl, 
	IDataBoundListControl, IDataBoundControl, IFieldControl
<asp:GridView />

Le type GridView expose les membres suivants.

  NomDescription
Méthode publiqueGridViewInitialise une nouvelle instance de la classe GridView.
Début

  NomDescription
Propriété publiqueAccessKeyObtient 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éeAdapterObtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAllowPagingObtient ou définit une valeur indiquant si la fonctionnalité de pagination est activée.
Propriété publiqueAllowSortingObtient ou définit une valeur indiquant si la fonctionnalité de tri est activée.
Propriété publiqueAlternatingRowStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de lignes de données en alternance dans un contrôle GridView.
Propriété publiqueAppRelativeTemplateSourceDirectoryObtient 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é publiqueAttributesObtient 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é publiqueAutoGenerateColumnsObtient ou définit une valeur indiquant si les champs liés sont créés automatiquement pour chaque champ dans la source de données.
Propriété publiqueAutoGenerateDeleteButtonObtient ou définit une valeur indiquant si une colonne de champs CommandField avec un bouton Supprimer pour chaque ligne de données est ajoutée automatiquement à un contrôle GridView.
Propriété publiqueAutoGenerateEditButtonObtient ou définit une valeur indiquant si une colonne de champs CommandField avec un bouton Modifier pour chaque ligne de données est ajoutée automatiquement à un contrôle GridView.
Propriété publiqueAutoGenerateSelectButtonObtient ou définit une valeur indiquant si une colonne de champs CommandField avec un bouton Sélectionner pour chaque ligne de données est ajoutée automatiquement à un contrôle GridView.
Propriété publiqueBackColorObtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBackImageUrlObtient ou définit l'URL d'une image à afficher à l'arrière-plan d'un contrôle GridView.
Propriété publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publiqueBorderColorObtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publiqueBorderStyleObtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBorderWidthObtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBottomPagerRowObtient un objet GridViewRow qui représente la ligne du bas de pagineur dans un contrôle GridView.
Propriété publiqueCaptionObtient ou définit le texte à afficher dans un élément de légende HTML d'un contrôle GridView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.
Propriété publiqueCaptionAlignObtient ou définit la position horizontale ou verticale de l'élément de légende HTML dans un contrôle GridView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.
Propriété publiqueCellPaddingObtient ou définit l'espace entre le contenu d'une cellule et la bordure de celle-ci.
Propriété publiqueCellSpacingObtient ou définit l'espace entre les cellules.
Propriété protégéeChildControlsCreatedObtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publiqueClientIDObtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.)
Propriété publiqueClientIDModeObtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.)
Propriété publiqueClientIDRowSuffixObtient ou définit les noms des champs de données dont les valeurs sont ajoutées à la valeur de propriété ClientID pour identifier de façon unique chaque instance d'un contrôle lié aux données.
Propriété publiqueClientIDRowSuffixDataKeysInfrastructure. Obtient les valeurs de données utilisées pour identifier de façon unique chaque instance d'un contrôle lié aux données lorsqu'ASP.NET génère la valeur ClientID.
Propriété protégéeClientIDSeparatorObtient 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é publiqueColumnsObtient une collection d'objets DataControlField qui représentent les champs de colonnes du contrôle GridView.
Propriété publiqueColumnsGeneratorObtient ou définit le contrôle qui générera automatiquement les colonnes d'un contrôle GridView qui utilise des fonctionnalités Dynamic Data ASP.NET.
Propriété protégéeContextObtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.)
Propriété publiqueControlsObtient une collection de contrôles enfants dans le contrôle composite lié aux données. (Hérité de CompositeDataBoundControl.)
Propriété publiqueControlStyleObtient 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é publiqueControlStyleCreatedObtient 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é publiqueCssClassObtient 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é publiqueDataItemContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.)
Propriété publiqueDataKeyNamesObtient ou définit un tableau qui contient les noms des champs clés primaires pour les éléments affichés dans un contrôle GridView.
Propriété publiqueDataKeysObtient une collection d'objets DataKey qui représentent la valeur de clé de données de chaque ligne du contrôle GridView.
Propriété publiqueDataKeysContainerObtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.)
Propriété publiqueDataMemberObtient ou définit le nom de la liste des données auxquelles le contrôle lié aux données se lie, dans les cas où la source de données contient plusieurs listes distinctes d'éléments de données. (Hérité de DataBoundControl.)
Propriété publiqueDataSourceObtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de BaseDataBoundControl.)
Propriété publiqueDataSourceIDObtient ou définit l'ID du contrôle duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de DataBoundControl.)
Propriété publiqueDataSourceObjectObtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet. (Hérité de DataBoundControl.)
Propriété protégéeDesignModeObtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publiqueEditIndexObtient ou définit l'index de la ligne à modifier.
Propriété publiqueEditRowStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne sélectionnée pour modification dans un contrôle GridView.
Propriété publiqueEmptyDataRowStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de données vide rendue lorsqu'un contrôle GridView est lié à une source de données qui ne contient pas d'enregistrements.
Propriété publiqueEmptyDataTemplateObtient ou définit le contenu défini par l'utilisateur de la ligne de données vide rendue lorsqu'un contrôle GridView est lié à une source de données qui ne contient pas d'enregistrements.
Propriété publiqueEmptyDataTextObtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu'un contrôle GridView est lié à une source de données qui ne contient pas d'enregistrements.
Propriété publiqueEnabledObtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publiqueEnableModelValidationObtient ou définit une valeur qui indique si un contrôle de validateur doit gérer les exceptions susceptibles de se produire lors des opérations d'insertion ou de mise à jour.
Propriété publiqueEnablePersistedSelectionObtient ou définit une valeur qui indique si la sélection d'une ligne est basée sur l'index ou sur les valeurs de clés de données.
Propriété publiqueEnableSortingAndPagingCallbacksObtient ou définit une valeur indiquant si les rappels côté client sont utilisés pour les opérations de tri et de pagination.
Propriété publiqueEnableThemingObtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publiqueEnableViewStateObtient 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éeEventsObtient 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é publiqueFontObtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueFooterRowObtient un objet GridViewRow qui représente la ligne de pied de page dans un contrôle GridView.
Propriété publiqueFooterStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pied de page dans un contrôle GridView.
Propriété publiqueForeColorObtient 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é publiqueGridLinesObtient ou définit le style de quadrillage d'un contrôle GridView.
Propriété publiqueHasAttributesObtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégéeHasChildViewStateObtient 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é publiqueHeaderRowObtient un objet GridViewRow qui représente la ligne d'en-tête dans un contrôle GridView.
Propriété publiqueHeaderStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne d'en-tête dans un contrôle GridView.
Propriété publiqueHeightObtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueHorizontalAlignObtient ou définit l'alignement horizontal d'un contrôle GridView sur la page.
Propriété publiqueIDObtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégéeIdSeparatorInfrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.)
Propriété protégéeInitializedObtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl.)
Propriété protégéeIsBoundUsingDataSourceIDObtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl.)
Propriété protégéeIsChildControlStateClearedObtient 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éeIsEnabledObtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégéeIsTrackingViewStateObtient 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éeIsViewStateEnabledObtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété protégéeLoadViewStateByIDObtient 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é publiqueNamingContainerObtient 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é publiquePageObtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publiquePageCountObtient le nombre de pages requis pour afficher les enregistrements de la source de données dans un contrôle GridView.
Propriété publiquePageIndexObtient ou définit l'index de la page actuellement affichée.
Propriété publiquePagerSettingsObtient une référence à l'objet PagerSettings vous permettant de définir les propriétés des boutons du pagineur dans un contrôle GridView.
Propriété publiquePagerStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pagineur dans un contrôle GridView.
Propriété publiquePagerTemplateObtient ou définit le contenu personnalisé de la ligne de pagineur dans un contrôle GridView.
Propriété publiquePageSizeObtient ou définit le nombre d'enregistrements à afficher sur une page d'un contrôle GridView.
Propriété publiqueParentObtient 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é publiqueRenderingCompatibilityObtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.)
Propriété protégéeRequiresDataBindingObtient ou définit une valeur indiquant si la méthode DataBind doit être appelée. (Hérité de BaseDataBoundControl.)
Propriété publiqueRowHeaderColumnObtient ou définit le nom de la colonne à utiliser comme en-tête de colonne du contrôle GridView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.
Propriété publiqueRowsObtient une collection d'objets GridViewRow qui représentent les lignes de données d'un contrôle GridView.
Propriété publiqueRowStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de lignes de données dans un contrôle GridView.
Propriété protégéeSelectArgumentsObtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données à partir d'un contrôle de source de données. (Hérité de DataBoundControl.)
Propriété publiqueSelectedDataKeyObtient l'objet DataKey qui contient la valeur de clés des données de la ligne sélectionnée dans un contrôle GridView.
Propriété publiqueSelectedIndexObtient ou définit l'index de la ligne sélectionnée dans un contrôle GridView.
Propriété publiqueSelectedPersistedDataKeyObtient ou définit la valeur de clé de données de l'élément persistant sélectionné dans un contrôle GridView.
Propriété publiqueSelectedRowObtient une référence à un objet GridViewRow qui représente la ligne sélectionnée dans le contrôle.
Propriété publiqueSelectedRowStyleObtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne sélectionnée dans un contrôle GridView.
Propriété publiqueSelectedValueObtient la valeur de clés des données de la ligne sélectionnée dans un contrôle GridView.
Propriété publiqueShowFooterObtient ou définit une valeur indiquant si la ligne du pied de page s'affiche dans un contrôle GridView.
Propriété publiqueShowHeaderObtient ou définit une valeur indiquant si la ligne de l'en-tête s'affiche dans un contrôle GridView.
Propriété publiqueShowHeaderWhenEmptyObtient ou définit une valeur qui indique si le titre d'une colonne dans le contrôle GridView est visible lorsque la colonne n'a pas de données.
Propriété publiqueSiteObtient 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é publiqueSkinIDObtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publiqueSortDirectionObtient le sens du tri de la colonne en cours de tri.
Propriété publiqueSortedAscendingCellStyleObtient ou définit le style CSS pour une colonne GridView lorsque la colonne est triée dans l'ordre croissant.
Propriété publiqueSortedAscendingHeaderStyleObtient ou définit le style CSS à appliquer à un en-tête de colonne GridView lorsque la colonne est triée dans l'ordre croissant.
Propriété publiqueSortedDescendingCellStyleObtient ou définit le style d'une colonne GridView lorsque la colonne est triée dans l'ordre décroissant.
Propriété publiqueSortedDescendingHeaderStyleObtient ou définit le style à appliquer à un en-tête de colonne GridView lorsque la colonne est triée dans l'ordre décroissant.
Propriété publiqueSortExpressionObtient l'expression de tri associée à la ou les colonnes en cours de tri.
Propriété publiqueStyleObtient 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é publiqueSupportsDisabledAttributeObtient 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 BaseDataBoundControl.)
Propriété publiqueTabIndexObtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeTagKeyObtient la valeur HtmlTextWriterTag du contrôle GridView. (Substitue WebControl.TagKey.)
Propriété protégéeTagNameObtient 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é publiqueTemplateControlObtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueTemplateSourceDirectoryObtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.)
Propriété publiqueToolTipObtient 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é publiqueTopPagerRowObtient un objet GridViewRow qui représente la ligne du haut du pagineur dans un contrôle GridView.
Propriété publiqueUniqueIDObtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.)
Propriété publiqueUseAccessibleHeaderObtient ou définit une valeur indiquant si un contrôle GridView 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.
Propriété protégéeViewStateObtient 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éeViewStateIgnoresCaseObtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.)
Propriété publiqueViewStateModeObtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publiqueVisibleObtient 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é publiqueWidthObtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début

  NomDescription
Méthode protégéeAddAttributesToRenderAjoute 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éeAddedControlAppelé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éeAddParsedSubObjectAvertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à l'objet ControlCollection du contrôle serveur. (Hérité de Control.)
Méthode publiqueApplyStyleCopie 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 publiqueApplyStyleSheetSkinApplique 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éeBuildProfileTreeInfrastructure. 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éeClearCachedClientIDInfrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.)
Méthode protégéeClearChildControlStateSupprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildStateSupprime 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éeClearChildViewStateSupprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearEffectiveClientIDModeInfrastructure. 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 protégéeConfirmInitStateDéfinit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl.)
Méthode publiqueCopyBaseAttributesCopie 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éeCreateAutoGeneratedColumnCrée un champ de colonne généré automatiquement.
Méthode protégéeCreateChildControls()Infrastructure. Crée la hiérarchie des contrôles utilisée pour restituer un contrôle composite lié aux données basé sur les valeurs qui sont stockées dans l'état d'affichage. (Hérité de CompositeDataBoundControl.)
Méthode protégéeCreateChildControls(IEnumerable, Boolean)Infrastructure. Crée la hiérarchie des contrôles utilisée pour rendre le contrôle GridView à l'aide de la source de données spécifiée. (Substitue CompositeDataBoundControl.CreateChildControls(IEnumerable, Boolean).)
Méthode protégéeCreateChildTableInfrastructure. Crée une table enfant.
Méthode protégéeCreateColumnsCrée le jeu de champs de colonnes utilisé pour générer la hiérarchie des contrôles.
Méthode protégéeCreateControlCollectionCré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éeCreateControlStyleInfrastructure. Crée le style par défaut du contrôle. (Substitue WebControl.CreateControlStyle().)
Méthode protégéeCreateDataSourceSelectArgumentsCrée l'objet DataSourceSelectArguments qui contient les arguments passés à la source de données pour être traités. (Substitue DataBoundControl.CreateDataSourceSelectArguments().)
Méthode protégéeCreateRowCrée une ligne de pagineur dans le contrôle GridView.
Méthode publiqueDataBind()Lie la source de données au contrôle GridView. Cette méthode ne peut pas être héritée. (Substitue BaseDataBoundControl.DataBind().)
Méthode protégéeDataBind(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éeDataBindChildrenLie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publiqueDeleteRowSupprime l'enregistrement à l'index spécifié de la source de données.
Méthode publiqueDisposePermet à 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éeEnsureChildControlsDé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éeEnsureDataBoundAppelle la méthode DataBind si la propriété DataSourceID est définie et que le contrôle lié aux données est marqué pour demander à être lié. (Hérité de BaseDataBoundControl.)
Méthode protégéeEnsureIDCrée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.)
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéeExtractRowValuesRécupère les valeurs de chaque champ déclarées dans la ligne spécifiée et les stocke dans l'objet IOrderedDictionary spécifié.
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindControl(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éeFindControl(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 publiqueFocusAffecte le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégéeGetCallbackResultRetourne le résultat d'un événement de rappel qui cible un contrôle.
Méthode protégéeGetCallbackScriptCrée le script de rappel pour un bouton qui exécute une opération de tri.
Méthode protégéeGetDataRécupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données. (Hérité de DataBoundControl.)
Méthode protégéeGetDataSourceRécupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant. (Hérité de DataBoundControl.)
Méthode protégéeGetDesignModeStateInfrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetRouteUrl(Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(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 publiqueGetRouteUrl(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 publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetUniqueIDRelativeToRetourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publiqueHasControlsDétermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégéeHasEventsRetourne 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éeInitializePagerInitialise la ligne de pagineur affichée lorsque la fonctionnalité de pagination est activée.
Méthode protégéeInitializeRowInitialise une ligne de pagineur dans le contrôle GridView.
Méthode publiqueIsBindableTypeDétermine si le type de données spécifié peut être lié à une colonne dans un contrôle GridView.
Méthode protégéeIsLiteralContentInfrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.)
Méthode protégéeLoadControlStateInfrastructure. Charge l'état des propriétés du contrôle GridView à faire persister, même lorsque la propriété Control.EnableViewState a la valeur false. (Substitue Control.LoadControlState(Object).)
Méthode protégéeLoadViewStateCharge l'état d'affichage du contrôle GridView enregistré précédemment. (Substitue WebControl.LoadViewState(Object).)
Méthode protégéeMapPathSecureRé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éeMarkAsDataBoundDéfinit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données. (Hérité de DataBoundControl.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueMergeStyleCopie 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éeOnBubbleEventDétermine si l'événement pour les contrôles serveur Web est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Substitue Control.OnBubbleEvent(Object, EventArgs).)
Méthode protégéeOnDataBindingDéclenche l'événement DataBinding. (Hérité de Control.)
Méthode protégéeOnDataBoundDéclenche l'événement DataBound. (Hérité de BaseDataBoundControl.)
Méthode protégéeOnDataPropertyChangedRelie le contrôle GridView à ses données après la modification de la propriété DataMember, DataSource, ou DataSourceID. (Substitue DataBoundControl.OnDataPropertyChanged().)
Méthode protégéeOnDataSourceViewChangedDéclenche l'événement DataSourceViewChanged. (Substitue DataBoundControl.OnDataSourceViewChanged(Object, EventArgs).)
Méthode protégéeOnInitDéclenche l'événement Control.Init. (Substitue BaseDataBoundControl.OnInit(EventArgs).)
Méthode protégéeOnLoadGère l'événement Control.Load. (Hérité de DataBoundControl.)
Méthode protégéeOnPageIndexChangedDéclenche l'événement PageIndexChanged.
Méthode protégéeOnPageIndexChangingDéclenche l'événement PageIndexChanging.
Méthode protégéeOnPagePreLoadDéfinit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. (Substitue DataBoundControl.OnPagePreLoad(Object, EventArgs).)
Méthode protégéeOnPreRenderInfrastructure. Déclenche l'événement PreRender. (Substitue BaseDataBoundControl.OnPreRender(EventArgs).)
Méthode protégéeOnRowCancelingEditDéclenche l'événement RowCancelingEdit.
Méthode protégéeOnRowCommandDéclenche l'événement RowCommand.
Méthode protégéeOnRowCreatedDéclenche l'événement RowCreated.
Méthode protégéeOnRowDataBoundDéclenche l'événement RowDataBound.
Méthode protégéeOnRowDeletedDéclenche l'événement RowDeleted.
Méthode protégéeOnRowDeletingDéclenche l'événement RowDeleting.
Méthode protégéeOnRowEditingDéclenche l'événement RowEditing.
Méthode protégéeOnRowUpdatedDéclenche l'événement RowUpdated.
Méthode protégéeOnRowUpdatingDéclenche l'événement RowUpdating.
Méthode protégéeOnSelectedIndexChangedDéclenche l'événement SelectedIndexChanged.
Méthode protégéeOnSelectedIndexChangingDéclenche l'événement SelectedIndexChanging.
Méthode protégéeOnSortedDéclenche l'événement Sorted.
Méthode protégéeOnSortingDéclenche l'événement Sorting.
Méthode protégéeOnUnloadDéclenche l'événement Unload. (Hérité de Control.)
Méthode protégéeOpenFileObtient un Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégéePerformDataBindingInfrastructure. Lie la source de données spécifiée au contrôle GridView. (Substitue CompositeDataBoundControl.PerformDataBinding(IEnumerable).)
Méthode protégéePerformSelectRécupère les données de la source de données associée. (Hérité de DataBoundControl.)
Méthode protégéePrepareControlHierarchyInfrastructure. Établit la hiérarchie des contrôles.
Méthode protégéeRaiseBubbleEventAssigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégéeRaiseCallbackEventCrée les arguments du gestionnaire de rappel de la méthode GetCallbackEventReference.
Méthode protégéeRaisePostBackEventDéclenche les événements appropriés pour le contrôle GridView lors de la publication sur le serveur.
Méthode protégéeRemovedControlAppelé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éeRenderInfrastructure. Génère le rendu du contenu du contrôle serveur Web au navigateur du client à l'aide de l'objet System.Web.UI.HtmlTextWriter spécifié. (Substitue WebControl.Render(HtmlTextWriter).)
Méthode publiqueRenderBeginTagGé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éeRenderChildrenRenvoie 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éeRenderContentsGé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 publiqueRenderControl(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éeRenderControl(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 publiqueRenderEndTagGé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éeResolveAdapterObtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.)
Méthode publiqueResolveClientUrlObtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.)
Méthode publiqueResolveUrlConvertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.)
Méthode protégéeSaveControlStateInfrastructure. Enregistre l'état des propriétés du contrôle GridView à faire persister, même lorsque la propriété Control.EnableViewState a la valeur false. (Substitue Control.SaveControlState().)
Méthode protégéeSaveViewStateInfrastructure. Charge l'état d'affichage du contrôle GridView enregistré précédemment. (Substitue WebControl.SaveViewState().)
Méthode publiqueSelectRowSélectionne la ligne à modifier dans un contrôle GridView.
Méthode protégéeSetDesignModeStateDéfinit les données au moment du design pour un contrôle. (Hérité de Control.)
Méthode publiqueSetEditRowMet une ligne en mode édition dans un contrôle GridView en utilisant l'index de ligne spécifié.
Méthode publiqueSetPageIndexDéfinit l'index de page du contrôle GridView en utilisant l'index de ligne.
Méthode publiqueSetRenderMethodDelegateInfrastructure. 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 publiqueSortTrie le contrôle GridView selon l'expression et le sens de tri spécifiés.
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégéeTrackViewStateInfrastructure. Suit les modifications d'état d'affichage du contrôle GridView afin qu'elles puissent être stockées dans l'objet System.Web.UI.StateBag du contrôle. Cet objet est accessible via la propriété Control.ViewState. (Substitue WebControl.TrackViewState().)
Méthode publiqueUpdateRowMet à jour l'enregistrement à l'index de ligne spécifié à l'aide des valeurs de champ de la ligne.
Méthode protégéeValidateDataSourceVérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner. (Hérité de DataBoundControl.)
Début

  NomDescription
Événement publicDataBindingSe produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement publicDataBoundSe produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl.)
Événement publicDisposedSe 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 publicInitSe 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 publicLoadSe produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.)
Événement publicPageIndexChangedSe produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle GridView a géré l'opération de pagination.
Événement publicPageIndexChangingSe produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle GridView n'ait géré l'opération de pagination.
Événement publicPreRenderSe produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.)
Événement publicRowCancelingEditSe produit lorsqu'un clic est effectué sur le bouton Annuler d'une ligne en mode édition, mais avant que la ligne ne quitte le mode édition.
Événement publicRowCommandSe produit lorsqu'un clic est effectué sur un bouton dans un contrôle GridView.
Événement publicRowCreatedSe produit lorsqu'une ligne est créée dans un contrôle GridView.
Événement publicRowDataBoundSe produit lorsqu'une ligne de données est liée aux données dans un contrôle GridView.
Événement publicRowDeletedSe produit lorsqu'un clic est effectué sur le bouton Supprimer d'une ligne, mais après que le contrôle GridView a supprimé la ligne.
Événement publicRowDeletingSe produit lorsqu'un clic est effectué sur le bouton Supprimer d'une ligne, mais avant que le contrôle GridView n'ait supprimé la ligne.
Événement publicRowEditingSe produit lors d'un clic sur le bouton Modification d'une ligne, mais avant que le contrôle GridView ne passe en mode édition.
Événement publicRowUpdatedSe produit lors d'un clic sur le bouton Mise à jour d'une ligne, mais après que le contrôle GridView a mis la ligne à jour.
Événement publicRowUpdatingSe produit lors d'un clic sur le bouton Mise à jour d'une ligne, mais avant que le contrôle GridView ne mette la ligne à jour.
Événement publicSelectedIndexChangedSe produit en cas de clic sur le bouton de sélection d'une ligne, mais après que le contrôle GridView a géré l'opération de sélection.
Événement publicSelectedIndexChangingSe produit en cas de clic sur le bouton de sélection d'une ligne, mais avant que le contrôle GridView ne gère l'opération de sélection.
Événement publicSortedSe produit en cas de clic sur le lien hypertexte de tri d'une colonne, mais après que le contrôle GridView a géré l'opération de tri.
Événement publicSortingSe produit en cas de clic sur le lien hypertexte de tri d'une colonne, mais avant que le contrôle GridView ne gère l'opération de tri.
Événement publicUnloadSe produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début

  NomDescription
Méthode d'extension publiqueEnablePersistedSelectionRend la sélection persistante dans les contrôles de données qui prennent en charge la sélection et la pagination. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindDataSourceControlRetourne 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 publiqueFindFieldTemplateRetourne 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 publiqueFindMetaTableRetourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.GetAttributeInfrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.SetAttributeAffecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface expliciteMéthode privéeICallbackContainer.GetCallbackScriptInfrastructure. Crée le script de rappel pour un bouton qui exécute une opération de tri.
Implémentation d'interface expliciteMéthode privéeICallbackEventHandler.GetCallbackResultInfrastructure. Retourne le résultat d'un événement de rappel qui cible un contrôle.
Implémentation d'interface expliciteMéthode privéeICallbackEventHandler.RaiseCallbackEventInfrastructure. Crée les arguments du gestionnaire de rappel de la méthode GetCallbackEventReference.
Implémentation d'interface explicitePropriété privéeIControlBuilderAccessor.ControlBuilderPour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.GetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetDesignModeStatePour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetOwnerControlInfrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIControlDesignerAccessor.UserDataPour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.DataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.HasDataBindingsPour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBoundControl.DataKeyNamesObtient ou définit les noms des champs clés primaires pour les éléments affichés dans un contrôle lié aux données.
Implémentation d'interface explicitePropriété privéeIDataBoundControl.DataMemberObtient ou définit le tableau exposé par le contrôle de source de données à lier au contrôle lié aux données.
Implémentation d'interface explicitePropriété privéeIDataBoundControl.DataSourceObtient ou définit l'objet source de données duquel le contrôle lié aux données récupère la liste d'éléments de données.
Implémentation d'interface explicitePropriété privéeIDataBoundControl.DataSourceIDObtient ou définit l'ID de la source de données de laquelle le contrôle lié aux données récupère la liste d'éléments de données.
Implémentation d'interface explicitePropriété privéeIDataBoundControl.DataSourceObjectObtient ou définit l'objet source de données duquel le contrôle lié aux données récupère la liste d'éléments de données.
Implémentation d'interface explicitePropriété privéeIDataBoundListControl.ClientIDRowSuffixObtient ou définit les noms des champs de données dont les valeurs sont ajoutées à la valeur de propriété ClientID pour identifier de façon unique chaque instance d'un contrôle lié aux données.
Implémentation d'interface explicitePropriété privéeIDataBoundListControl.DataKeysObtient une collection d'objets qui représentent la valeur DataKeys dans un contrôle lié aux données.
Implémentation d'interface explicitePropriété privéeIDataBoundListControl.EnablePersistedSelectionObtient ou définit une valeur qui indique si la sélection d'une ligne est basée sur l'index ou sur les valeurs de clés de données.
Implémentation d'interface explicitePropriété privéeIDataBoundListControl.SelectedDataKeyObtient l'objet qui contient la valeur de clés des données de la ligne sélectionnée dans un contrôle lié aux données.
Implémentation d'interface explicitePropriété privéeIDataBoundListControl.SelectedIndexObtient ou définit l'index de la ligne sélectionnée dans le contrôle lié aux données.
Implémentation d'interface explicitePropriété privéeIDataKeysControl.ClientIDRowSuffixDataKeysInfrastructure. Obtient les valeurs de données utilisées pour identifier de façon unique chaque instance d'un contrôle lié aux données lorsqu'ASP.NET génère la valeur ClientID.
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.ExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.HasExpressionsPour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIFieldControl.FieldsGeneratorObtient ou définit le contrôle qui génère automatiquement les colonnes d'un contrôle lié aux données utilisées par Dynamic Data ASP.NET.
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIPersistedSelector.DataKeyPour obtenir une description de ce membre, consultez IPersistedSelector.DataKey.
Implémentation d'interface expliciteMéthode privéeIPostBackContainer.GetPostBackOptionsInfrastructure. Crée un objet PostBackOptions qui représente le comportement de publication (postback) du contrôle bouton spécifié.
Implémentation d'interface expliciteMéthode privéeIPostBackEventHandler.RaisePostBackEventInfrastructure. Déclenche les événements appropriés pour le contrôle GridView lors de la publication sur le serveur.
Début

Dans cette rubrique :

Introduction

Le contrôle GridView est utilisé pour afficher les valeurs d'une source de données dans une table. Chaque colonne représente un champ tandis que chaque ligne représente un enregistrement. Le contrôle GridView prend en charge les fonctionnalités suivantes :

  • Liaison aux contrôles de source de données, telle que SqlDataSource.

  • Fonctionnalités intégrées de tri.

  • Fonctionnalités intégrées de mise à jour et de suppression.

  • Fonctionnalités intégrées de pagination.

  • Fonctionnalités intégrées de sélection de ligne.

  • Accès par programme au modèle objet GridView pour définir des propriétés de manière dynamique, gérer les événements, etc.

  • Plusieurs champs clés.

  • Plusieurs champs de données pour les colonnes de lien hypertexte.

  • Apparence personnalisable via des thèmes et des styles.

  • Pour en savoir plus sur les autres contrôles liés aux données, qui sont disponibles dans ASP.NET, consultez Vue d'ensemble des contrôles serveur Web liés aux données ASP.NET.

RemarqueRemarque

Si vous êtes familiarisé avec le contrôle DataGrid à partir de la version 1.0 du .NET Framework, le contrôle GridView succède au contrôle DataGrid.

Champs de colonnes

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

Vous pouvez aussi contrôler les colonnes qui doivent apparaître dans le contrôle GridView en définissant la propriété AutoGenerateColumns avec la valeur false et en définissant votre propre collection de champs de colonnes. Différents types de champs de colonnes déterminent le comportement des colonnes dans le contrôle. Le tableau suivant affiche les différents types de champs de colonnes qui peuvent être utilisés.

Type de champ de colonne

Description

BoundField

Affiche la valeur d'un champ dans une source de données. Il s'agit du type de colonne par défaut du contrôle GridView.

ButtonField

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

CheckBoxField

Affiche une case à cocher pour chaque élément dans le contrôle GridView. Ce type de champ de colonne est couramment utilisé pour afficher les champs avec une valeur Boolean.

CommandField

Affiche des boutons de commande prédéfinis pour exécuter la sélection, la modification ou la suppression d'opérations.

HyperLinkField

Affiche la valeur d'un champ dans une source de données sous la forme de lien hypertexte. Ce type de champ de colonne vous permet de lier un deuxième champ à l'URL du lien hypertexte.

ImageField

Affiche une image pour chaque élément dans le contrôle GridView.

TemplateField

Affiche le contenu défini par l'utilisateur pour chaque élément dans le contrôle GridView en fonction d'un modèle spécifié. Ce type de champ de colonne vous permet de créer un champ de colonne personnalisé.

Pour définir une collection de champs de colonnes de manière déclarative, ajoutez d'abord les balises <Columns> d'ouverture et de fermeture entre les balises d'ouverture et de fermeture du contrôle GridView. Ensuite, répertoriez les champs de colonnes que vous souhaitez inclure entre les balises d'ouverture et de fermeture <Columns>. Les colonnes spécifiées sont ajoutées à la collection Columns dans l'ordre répertorié. La collection Columns stocke tous les champs de colonnes dans le contrôle et vous permet de gérer par programme les champs de colonnes dans le contrôle GridView.

Les champs de colonnes déclarés explicitement peuvent être affichés dans une combinaison de champs de colonnes générés automatiquement. Lorsque vous utilisez les deux types de colonnes, les champs de colonnes déclarés explicitement sont rendus en premier, suivis des champs de colonnes générés automatiquement.

RemarqueRemarque

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

Liaison de données

Le contrôle GridView peut être lié à un contrôle de source de données (tel que SqlDataSource ou ObjectDataSource) ou à toute source de données qui implémente l'interface System.Collections.IEnumerable, telle que System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T> ou autres types de collection. Utilisez l'une des méthodes suivantes pour lier le contrôle GridView au type de source de données approprié :

  • Pour lier à un contrôle de source de données, affectez à la propriété DataSourceID du contrôle GridView la valeur ID du contrôle de source de données. Le contrôle GridView lie automatiquement le contrôle de source de données spécifié et peut tirer parti des fonctionnalités du contrôle de source de données pour exécuter les fonctionnalités de tri, de mise à jour, de suppression et de pagination. Il s'agit de la méthode recommandée de liaison aux données.

  • Pour établir une liaison avec une source de données qui implémente l'interface System.Collections.IEnumerable, affectez par programme la source de données à la propriété DataSource du contrôle GridView, puis appelez la méthode DataBind. Lors de l'utilisation de cette méthode, le contrôle GridView ne fournit pas de fonctionnalités intégrées de tri, de mise à jour, de suppression et de pagination. Vous devez fournir ces fonctionnalités en utilisant l'événement approprié.

Pour plus d'informations sur la liaison de données, consultez Accès aux données ASP.NET.

RemarqueRemarque

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. Dans la mesure du possible, il est fortement recommandé que les valeurs soient encodées en HTML avant d'être affichées dans ce contrôle (la classe BoundField code en HTML les valeurs par défaut). 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 Introduction to the Validation Controls.

Opérations de données

Le contrôle GridView fournit plusieurs fonctionnalités intégrées qui permettent à l'utilisateur de trier, mettre à jour, supprimer, sélectionner et parcourir les éléments dans le contrôle. Lorsque le contrôle GridView est lié à un contrôle de source de données, le contrôle GridView peut tirer parti des fonctionnalités du contrôle de source de données et fournir les fonctionnalités automatiques de tri, de mise à jour et de suppression.

RemarqueRemarque

Le contrôle GridView peut fournir l'assistance pour trier, mettre à jour et supprimer avec d'autres types de sources de données. Toutefois, vous devrez fournir, avec l'implémentation, un gestionnaire d'événements approprié pour ces opérations.

Le tri permet à l'utilisateur de trier les éléments dans le contrôle GridView conformément à une colonne particulière en cliquant sur l'en-tête de la colonne. Pour activer le tri, affectez la valeur true à la propriété AllowSorting.

Les fonctionnalités automatiques de mise à jour, de suppression et de sélection sont activées lorsque vous cliquez sur le bouton d'un champ de colonne ButtonField ou TemplateField portant le nom de commande "Modifier", "Supprimer" et "Sélectionner" respectivement. Le contrôle GridView peut ajouter automatiquement un champ de colonne CommandField avec le bouton Modifier, Supprimer ou Sélectionner, respectivement, si la propriété AutoGenerateEditButton, AutoGenerateDeleteButton ou AutoGenerateSelectButton a la valeur true.

RemarqueRemarque

L'insertion d'enregistrements dans la source de données n'est pas prise en charge directement par le contrôle GridView. Toutefois, il est possible d'insérer des enregistrements à l'aide du contrôle GridView conjointement avec le contrôle DetailsView ou FormView. Pour plus d'informations, consultez DetailsView ou FormView, respectivement.

Au lieu d'afficher en même temps tous les enregistrements dans la source de données, le contrôle GridView peut scinder automatiquement les enregistrements en pages. Pour activer la pagination, attribuez la valeur true à la propriété AllowPaging.

RemarqueRemarque

Le contrôle GridView est recréé lors de la publication (postback) en fonction des informations stockées dans ViewState. Si le contrôle GridView inclut un TemplateField ou un CommandField dont la propriété CausesValidation a la valeur true, la propriété EnableViewState doit également avoir la valeur true pour garantir que les opérations de données simultanées, telles que les mises à jour et les suppressions, s'appliquent à la ligne appropriée.

Personnalisation de l'interface utilisateur

Vous pouvez personnaliser l'apparence du contrôle GridView en définissant les propriétés de style des différentes parties du contrôle. Le tableau suivant énumère les différentes propriétés de style.

Propriété de style

Description

AlternatingRowStyle

Paramètres de style pour les lignes de données en alternance dans le contrôle GridView. Lorsque cette propriété est définie, les lignes de données sont affichées en alternance entre les paramètres RowStyle et les paramètres AlternatingRowStyle.

EditRowStyle

Paramètres de style pour la ligne en cours d'édition dans le contrôle GridView.

EmptyDataRowStyle

Les paramètres de style de la ligne de données vide affichée dans le contrôle GridView lorsque la source de données ne contient pas d'enregistrements.

FooterStyle

Les paramètres de style pour la ligne de pied de page du contrôle GridView.

HeaderStyle

Les paramètres de style pour la ligne d'en-tête du contrôle GridView.

PagerStyle

Paramètres de style pour la ligne de pagineur dans le contrôle GridView.

RowStyle

Paramètres de style pour les lignes de données dans le contrôle GridView. Lorsque la propriété AlternatingRowStyle est également définie, les lignes de données sont affichées en alternance entre les paramètres RowStyle et les paramètres AlternatingRowStyle.

SelectedRowStyle

Paramètres de style pour la ligne sélectionnée dans le contrôle GridView.

SortedAscendingCellStyle

Le paramètre de style pour la colonne de données par laquelle les données sont triées dans le contrôle GridView. Lorsque ce style est défini, le style (par exemple, colonne en surbrillance) est appliqué aux cellules lorsque les données sont triées dans l'ordre croissant.

SortedAscendingHeaderStyle

Le paramètre de style pour la colonne de données par laquelle les données sont triées dans le contrôle GridView. Lorsque ce style est défini, une flèche qui indique que les données sont triées dans l'ordre croissant est placée sur l'en-tête du contrôle GridView lorsque les données sont triées dans l'ordre croissant.

SortedDescendingCellStyle

Le paramètre de style pour la colonne de données par laquelle les données sont triées dans le contrôle GridView. Lorsque ce style est défini, le style (par exemple, colonne en surbrillance) est appliqué aux cellules lorsque les données sont triées dans l'ordre décroissant.

SortedDescendingHeaderStyle

Le paramètre de style pour la colonne de données par laquelle les données sont triées dans le contrôle GridView. Lorsque ce style est défini, une flèche qui pointe vers le bas est placée sur l'en-tête de GridView lorsque les données sont triées dans l'ordre décroissant.

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

ShowHeader

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

Événements

Le contrôle GridView fournit plusieurs événements que vous pouvez programmer. Cela vous permet d'exécuter une routine personnalisée lorsqu'un événement se produit. Le tableau suivant répertorie les événements qui sont pris en charge par le contrôle GridView.

Événement

Description

PageIndexChanged

Se produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle GridView a géré l'opération de pagination. Cet événement est couramment utilisé lorsque vous devez exécuter une tâche une fois que l'utilisateur a navigué vers une page différente dans le contrôle.

PageIndexChanging

Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle GridView n'ait géré l'opération de pagination. Cet événement est souvent utilisé pour annuler l'opération de pagination.

RowCancelingEdit

Se produit lorsque l'utilisateur clique sur le bouton Annuler d'une ligne, mais avant que le contrôle GridView ne quitte le mode édition. Cet événement est souvent utilisé pour arrêter l'opération d'annulation.

RowCommand

Se produit lors d'un clic sur le bouton d'un contrôle GridView. Cet événement est souvent utilisé pour exécuter une tâche lorsqu'un clic est effectué dans le contrôle.

RowCreated

Se produit lorsqu'une ligne est créée dans le contrôle GridView. Cet événement est souvent utilisé pour modifier le contenu d'une ligne lorsque la ligne est créée.

RowDataBound

Se produit lorsqu'une ligne de données est liée aux données dans le contrôle GridView. Cet événement est souvent utilisé pour modifier le contenu d'une ligne lorsque la ligne est liée aux données.

RowDeleted

Se produit lorsque l'utilisateur clique sur le bouton Supprimer d'une ligne, mais une fois que le contrôle GridView a supprimé l'enregistrement de la source de données. Cet événement est souvent utilisé pour vérifier les résultats de l'opération de suppression.

RowDeleting

Se produit lorsque l'utilisateur clique sur le bouton Supprimer d'une ligne, mais avant que le contrôle GridView n'ait supprimé l'enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l'opération de suppression.

RowEditing

Se produit lors d'un clic sur le bouton Modification d'une ligne, mais avant que le contrôle GridView ne passe en mode édition. Cet événement est souvent utilisé pour annuler l'opération de modification.

RowUpdated

Se produit lors d'un clic sur le bouton Mise à jour d'une ligne, mais après que le contrôle GridView a mis la ligne à jour. Cet événement est souvent utilisé pour vérifier les résultats de l'opération de mise à jour.

RowUpdating

Se produit lors d'un clic sur le bouton Mise à jour d'une ligne, mais avant que le contrôle GridView ne mette la ligne à jour. Cet événement est souvent utilisé pour annuler l'opération de mise à jour.

SelectedIndexChanged

Se produit en cas de clic sur le bouton de sélection d'une ligne, mais après que le contrôle GridView a géré l'opération de sélection. Cet événement est souvent utilisé pour exécuter une tâche lorsqu'une ligne est sélectionnée dans le contrôle.

SelectedIndexChanging

Se produit en cas de clic sur le bouton de sélection d'une ligne, mais avant que le contrôle GridView ne gère l'opération de sélection. Cet événement est souvent utilisé pour annuler l'opération de sélection.

Sorted

Se produit en cas de clic sur le lien hypertexte de tri d'une colonne, mais après que le contrôle GridView a géré l'opération de tri. Cet événement est couramment utilisé pour exécuter une tâche une fois que l'utilisateur a cliqué sur un lien hypertexte pour trier une colonne.

Sorting

Se produit en cas de clic sur le lien hypertexte de tri d'une colonne, mais avant que le contrôle GridView ne gère l'opération de tri. Cet événement est souvent utilisé pour annuler l'opération de tri ou exécuter un programme de tri personnalisé.

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

<asp:GridView
    AccessKey="string"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateSelectButton="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"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditIndex="integer"
    EmptyDataText="string"
    Enabled="True|False"
    EnableSortingAndPagingCallbacks="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"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnRowCancelingEdit="RowCancelingEdit event handler"
    OnRowCommand="RowCommand event handler"
    OnRowCreated="RowCreated event handler"
    OnRowDataBound="RowDataBound event handler"
    OnRowDeleted="RowDeleted event handler"
    OnRowDeleting="RowDeleting event handler"
    OnRowEditing="RowEditing event handler"
    OnRowUpdated="RowUpdated event handler"
    OnRowUpdating="RowUpdating event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSelectedIndexChanging="SelectedIndexChanging event handler"
    OnSorted="Sorted event handler"
    OnSorting="Sorting event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|
        NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    PageSize="integer"
    RowHeaderColumn="string"
    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"
>
        <AlternatingRowStyle />
        <Columns>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Columns>
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FooterStyle />
        <HeaderStyle />
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle />
        <SelectedRowStyle />
</asp:GridView>
TopicLocation
Comment : créer des modèles de contrôle serveur Web ASP.NETGénération d'applications Web ASP.NET
Procédure pas à pas : liaison de données de pages Web à un composant de données Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher les données d'une base de données AccessGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la modification par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la suppression par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : modification et insertion de données dans les pages Web avec le contrôle serveur Web DetailsViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : tri simple pour le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des contrôles en vue d'une modification dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Access à l'aide du contrôle AccessDataSource (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : accès aux données de base dans les pages WebGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la sélection par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données à l'aide d'une procédure stockée dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la mise en page par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création de pages Web maître/détail dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : exécution de mises à jour en bloc de lignes liées à un contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle GridView imbriquéGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : accès aux données de base dans les pages WebGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridViewGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création de pages Web maître/détail dans Visual StudioGénération d'applications à l'aide de Visual Web Developer
Comment : activer la suppression par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : tri simple pour le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données de pages Web à un composant de données Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : modification et insertion de données dans les pages Web avec le contrôle serveur Web DetailsViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des contrôles en vue d'une modification dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Access à l'aide du contrôle AccessDataSourceGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements de bouton dans un contrôle GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la sélection par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET
Comment : répondre à des événements Button dans des éléments des contrôles DataList, Repeater ou GridViewGénération d'applications Web ASP.NET
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : définir dynamiquement la largeur de colonne d'un contrôle serveur Web GridViewGénération d'applications Web ASP.NET
Comment : activer la suppression par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : tri simple pour le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données de pages Web à un composant de données Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : modification et insertion de données dans les pages Web avec le contrôle serveur Web DetailsViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des contrôles en vue d'une modification dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôle Web ASP.NET de manière déclarativeGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une connexion à une base de données Access à l'aide du contrôle AccessDataSourceGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la sélection par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir dynamiquement la largeur de colonne d'un contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher les données d'une base de données AccessGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : exécution de mises à jour en bloc de lignes liées à un contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données à l'aide d'une procédure stockée dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la modification par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la mise en page par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle GridView imbriquéGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements de bouton dans des éléments DataList ou RepeaterGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements de bouton dans un contrôle GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer des modèles de contrôles serveur Web à l'aide du concepteurGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles de contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir dynamiquement la largeur de colonne d'un contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèlesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher les données d'une base de données AccessGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridViewdv_vwdcon
Procédure pas à pas : exécution de mises à jour en bloc de lignes liées à un contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données à l'aide d'une procédure stockée dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la modification par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : activer la mise en page par défaut dans le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle GridView imbriquéGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements de bouton dans des éléments DataList ou RepeaterGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio

Un projet de site Web Visual Studio contenant du code source est disponible pour accompagner cette rubrique : Download.

L'exemple de code suivant montre comment utiliser le contrôle GridView pour afficher les valeurs de la table Customers de l'exemple de base de données AdventureWorksLT dans Microsoft SQL Server. Les valeurs sont récupérées à l'aide d'un contrôle SqlDataSource.


<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>


L'exemple suivant montre comment utiliser le contrôle GridView et un contrôle LinqDataSource pour modifier des enregistrements.


<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>


Pour obtenir un exemple de code qui montre comment accéder aux valeurs des cellules, consultez GridViewRow.

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.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.

Date

Historique

Motif

Juillet 2008

Ajout de nouveaux membres : propriété ColumnsGenerator, propriété EnableModelValidation, propriété SelectedPersistedDataKey, propriété IPersistedSelector.DataKey.

Modifications de fonctionnalités dans le SP1.

Afficher: