Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataGrid classe

 

Date de publication : novembre 2016

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

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

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

public class DataGrid : BaseDataList, INamingContainer

NomDescription
System_CAPS_pubmethodDataGrid()

Initialise une nouvelle instance de la classe DataGrid.

NomDescription
System_CAPS_pubpropertyAccessKey

Obtient ou définit la clé d’accès qui vous permet de naviguer rapidement vers le contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_protpropertyAdapter

Obtient l’adaptateur spécifique au navigateur pour le contrôle.(Hérité de Control.)

System_CAPS_pubpropertyAllowCustomPaging

Obtient ou définit une valeur qui indique si la pagination personnalisée est activée.

System_CAPS_pubpropertyAllowPaging

Obtient ou définit une valeur qui indique si la pagination est activée.

System_CAPS_pubpropertyAllowSorting

Obtient ou définit une valeur qui indique si le tri est activé.

System_CAPS_pubpropertyAlternatingItemStyle

Obtient les propriétés de style des éléments alternés dans les DataGrid contrôle.

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l’application de la Page ou UserControl objet qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyAttributes

Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés sur le contrôle.(Hérité de WebControl.)

System_CAPS_pubpropertyAutoGenerateColumns

Obtient ou définit une valeur qui indique si BoundColumn objets sont automatiquement créés et affichés dans le DataGrid contrôle pour chaque champ dans la source de données.

System_CAPS_pubpropertyBackColor

Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_pubpropertyBackImageUrl

Obtient ou définit l’URL d’une image à afficher dans l’arrière-plan de la DataGrid contrôle.

System_CAPS_pubpropertyBindingContainer

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le contrôle qui contient la liaison de données de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyBorderColor

Obtient ou définit la couleur de bordure du contrôle Web.(Hérité de WebControl.)

System_CAPS_pubpropertyBorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_pubpropertyBorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_pubpropertyCaption

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 de périphériques de technologie d’assistance.(Hérité de BaseDataList.)

System_CAPS_pubpropertyCaptionAlign

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 de périphériques de technologie d’assistance.(Hérité de BaseDataList.)

System_CAPS_pubpropertyCellPadding

Obtient ou définit la quantité d’espace entre le contenu d’une cellule et la bordure de celle-ci.(Hérité de BaseDataList.)

System_CAPS_pubpropertyCellSpacing

Obtient ou définit la quantité d’espace entre les cellules.(Hérité de BaseDataList.)

System_CAPS_protpropertyChildControlsCreated

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.(Hérité de Control.)

System_CAPS_pubpropertyClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.(Hérité de Control.)

System_CAPS_pubpropertyClientIDMode

Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété.(Hérité de Control.)

System_CAPS_protpropertyClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans le ClientID propriété.(Hérité de Control.)

System_CAPS_pubpropertyColumns

Obtient une collection d’objets qui représentent les colonnes de la DataGrid contrôle.

System_CAPS_protpropertyContext

Obtient le HttpContext est associé au contrôle serveur pour la demande Web actuelle.(Hérité de Control.)

System_CAPS_pubpropertyControls

Obtient un System.Web.UI.ControlCollection objet qui contient une collection de contrôles enfants dans une contrôle de liste de données.(Hérité de BaseDataList.)

System_CAPS_pubpropertyControlStyle

Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_pubpropertyControlStyleCreated

Obtient une valeur indiquant si un Style objet a été créé pour le ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_pubpropertyCssClass

Obtient ou définit la classe de feuille de Style en cascade (CSS) restituée par le contrôle de serveur Web sur le client.(Hérité de WebControl.)

System_CAPS_pubpropertyCurrentPageIndex

Obtient ou définit l’index de la page actuellement affichée.

System_CAPS_pubpropertyDataItemContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataItemContainer.(Hérité de Control.)

System_CAPS_pubpropertyDataKeyField

Obtient ou définit le champ clé de la source de données spécifiée par la DataSource propriété.(Hérité de BaseDataList.)

System_CAPS_pubpropertyDataKeys

Obtient un DataKeyCollection objet qui stocke les valeurs de clé de chaque enregistrement dans une contrôle de liste de données.(Hérité de BaseDataList.)

System_CAPS_protpropertyDataKeysArray

Obtient un ArrayList objet qui contient les valeurs de clé de chaque enregistrement dans un contrôle de liste de données.(Hérité de BaseDataList.)

System_CAPS_pubpropertyDataKeysContainer

Obtient une référence au conteneur d’attribution de noms si celui-ci implémente IDataKeysControl.(Hérité de Control.)

System_CAPS_pubpropertyDataMember

Obtient ou définit le membre de données spécifique dans une source de données multimembre à lier à un contrôle de liste de données.(Hérité de BaseDataList.)

System_CAPS_pubpropertyDataSource

Obtient ou définit la source contenant une liste de valeurs utilisées pour remplir les éléments dans le contrôle.(Hérité de BaseDataList.)

System_CAPS_pubpropertyDataSourceID

Obtient ou définit le ID propriété du contrôle de source de données que les contrôle de liste de données doivent utiliser pour récupérer sa source de données.(Hérité de BaseDataList.)

System_CAPS_protpropertyDesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertyEditItemIndex

Obtient ou définit l’index d’un élément dans le DataGrid contrôle à modifier.

System_CAPS_pubpropertyEditItemStyle

Obtient les propriétés de style de l’élément sélectionné à modifier dans le DataGrid contrôle.

System_CAPS_pubpropertyEnabled

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.(Hérité de WebControl.)

System_CAPS_pubpropertyEnableTheming

Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle.(Hérité de WebControl.)

System_CAPS_pubpropertyEnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.(Hérité de Control.)

System_CAPS_protpropertyEvents

Obtient une liste de délégués de gestionnaires d’événements pour le contrôle. Cette propriété est en lecture seule.(Hérité de Control.)

System_CAPS_pubpropertyFont

Obtient les propriétés de police associées au contrôle de serveur Web.(Hérité de WebControl.)

System_CAPS_pubpropertyFooterStyle

Obtient les propriétés de style de la section de pied de page dans le DataGrid contrôle.

System_CAPS_pubpropertyForeColor

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

System_CAPS_pubpropertyGridLines

Obtient ou définit une valeur qui indique si la bordure entre les cellules d’un contrôle de liste de données est affichée.(Hérité de BaseDataList.)

System_CAPS_pubpropertyHasAttributes

Obtient une valeur indiquant si le contrôle a des attributs défini.(Hérité de WebControl.)

System_CAPS_protpropertyHasChildViewState

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur actuel ont tous les paramètres d’état d’affichage enregistrés.(Hérité de Control.)

System_CAPS_pubpropertyHeaderStyle

Obtient les propriétés de style de la section d’en-tête dans la DataGrid contrôle.

System_CAPS_pubpropertyHeight

Obtient ou définit la hauteur du contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_pubpropertyHorizontalAlign

Obtient ou définit l’alignement horizontal du contrôle dans son conteneur.(Hérité de BaseDataList.)

System_CAPS_pubpropertyID

Obtient ou définit l’identificateur programmatique assigné au contrôle serveur.(Hérité de Control.)

System_CAPS_protpropertyIdSeparator

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient le caractère utilisé pour séparer les identificateurs de contrôle.(Hérité de Control.)

System_CAPS_protpropertyInitialized

Obtient une valeur indiquant si le contrôle a été initialisé.(Hérité de BaseDataList.)

System_CAPS_protpropertyIsBoundUsingDataSourceID

Obtient une valeur indiquant si le DataSourceID propriété est définie.(Hérité de BaseDataList.)

System_CAPS_protpropertyIsChildControlStateCleared

Obtient une valeur qui indique si les contrôles contenus dans ce contrôle ont état du contrôle.(Hérité de Control.)

System_CAPS_protpropertyIsEnabled

Obtient une valeur indiquant si le contrôle est activé.(Hérité de WebControl.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.(Hérité de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyItems

Obtient une collection de DataGridItem les objets qui représentent les éléments individuels dans le DataGrid contrôle.

System_CAPS_pubpropertyItemStyle

Obtient les propriétés de style des éléments de la DataGrid contrôle.

System_CAPS_protpropertyLoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage par ID au lieu de l’index.(Hérité de Control.)

System_CAPS_pubpropertyNamingContainer

Obtient une référence au contrôle de serveur de noms de conteneur, ce qui crée un espace de noms unique pour différencier les contrôles serveur avec le même Control.ID valeur de propriété.(Hérité de Control.)

System_CAPS_pubpropertyPage

Obtient une référence à la Page instance qui contient le contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyPageCount

Obtient le nombre total de pages requises pour afficher les éléments dans le DataGrid contrôle.

System_CAPS_pubpropertyPagerStyle

Obtient les propriétés de style de la section de pagination du DataGrid contrôle.

System_CAPS_pubpropertyPageSize

Obtient ou définit le nombre d’éléments à afficher sur une seule page de la DataGrid contrôle.

System_CAPS_pubpropertyParent

Obtient une référence au contrôle parent du contrôle de serveur dans la hiérarchie de contrôle de page.(Hérité de Control.)

System_CAPS_pubpropertyRenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET HTML restitué sera compatible avec.(Hérité de Control.)

System_CAPS_protpropertyRequiresDataBinding

Obtient ou définit une valeur indiquant si les contrôle de liste de données doit être lié à sa source de données spécifiée.(Hérité de BaseDataList.)

System_CAPS_protpropertySelectArguments

Obtient un DataSourceSelectArguments de l’objet que le contrôle lié aux données utilise lors de la récupération des données à partir d’un contrôle de source de données.(Hérité de BaseDataList.)

System_CAPS_pubpropertySelectedIndex

Obtient ou définit l'index de l'élément sélectionné dans le contrôle DataGrid.

System_CAPS_pubpropertySelectedItem

Obtient un DataGridItem objet qui représente l’élément sélectionné dans le DataGrid contrôle.

System_CAPS_pubpropertySelectedItemStyle

Obtient les propriétés de style de l’élément actuellement sélectionné dans le DataGrid contrôle.

System_CAPS_pubpropertyShowFooter

Obtient ou définit une valeur qui indique si le pied de page est affiché dans la DataGrid contrôle.

System_CAPS_pubpropertyShowHeader

Obtient ou définit une valeur qui indique si l’en-tête est affiché dans la DataGrid contrôle.

System_CAPS_pubpropertySite

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une aire de conception.(Hérité de Control.)

System_CAPS_pubpropertySkinID

Obtient ou définit l’apparence à appliquer au contrôle.(Hérité de WebControl.)

System_CAPS_pubpropertyStyle

Obtient une collection d’attributs de texte qui sera affiché comme un attribut de style sur la balise extérieure du contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_pubpropertySupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false.(Hérité de BaseDataList.)

System_CAPS_pubpropertyTabIndex

Obtient ou définit l’index de tabulation du contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_protpropertyTagKey

Obtient la valeur HtmlTextWriterTag du contrôle DataGrid.(Remplace WebControl.TagKey.)

System_CAPS_protpropertyTagName

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

System_CAPS_pubpropertyTemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtient le répertoire virtuel de le Page ou UserControl qui contient le contrôle serveur en cours.(Hérité de Control.)

System_CAPS_pubpropertyToolTip

Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web.(Hérité de WebControl.)

System_CAPS_pubpropertyUniqueID

Obtient l’identificateur unique qualifié hiérarchiquement du contrôle serveur.(Hérité de Control.)

System_CAPS_pubpropertyUseAccessibleHeader

Obtient ou définit une valeur indiquant si les 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 de périphériques de technologie d’assistance.(Hérité de BaseDataList.)

System_CAPS_pubpropertyValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie les entrées de client à partir du navigateur de valeurs potentiellement dangereuses.(Hérité de Control.)

System_CAPS_protpropertyViewState

Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et restaurer l’état d’affichage d’un contrôle serveur entre plusieurs demandes de la même page.(Hérité de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtient une valeur qui indique si le StateBag objet respecte la casse.(Hérité de Control.)

System_CAPS_pubpropertyViewStateMode

Obtient ou définit le mode d’état d’affichage de ce contrôle.(Hérité de Control.)

System_CAPS_pubpropertyVirtualItemCount

Obtient ou définit le nombre virtuel d’éléments dans le DataGrid contrôle lorsque la pagination personnalisée est utilisée.

System_CAPS_pubpropertyVisible

Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.(Hérité de Control.)

System_CAPS_pubpropertyWidth

Obtient ou définit la largeur du contrôle serveur web.(Hérité de WebControl.)

NomDescription
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

Ajoute les attributs HTML et des styles qui doivent être rendus spécifié HtmlTextWriterTag. Cette méthode est utilisée principalement par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_protmethodAddedControl(Control, Int32)

Appelée après qu’un contrôle enfant est ajouté à la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé et ajoute l’élément du contrôle serveur ControlCollection collection.(Hérité de BaseDataList.)

System_CAPS_pubmethodApplyStyle(Style)

Copie tous les éléments non vides du style spécifié au contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de page pour le contrôle.(Hérité de Control.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Commence le suivi au moment du design de données de rendu.(Hérité de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Rassemble des informations sur le contrôle serveur, puis les remet à la Trace propriété à afficher lorsque le traçage est activé pour la page.(Hérité de Control.)

System_CAPS_protmethodClearCachedClientID()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit la mise en cache ClientID valeur null.(Hérité de Control.)

System_CAPS_protmethodClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_protmethodClearChildState()

Supprime les informations d’état d’affichage et état du contrôle pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearChildViewState()

Supprime les informations d’état d’affichage pour tous les contrôles du contrôle serveur enfant.(Hérité de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit le ClientIDMode propriété de l’instance actuelle du contrôle et de ses contrôles enfants à Inherit.(Hérité de Control.)

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

Copie les propriétés non encapsulées par le Style objet du contrôle de serveur Web spécifié vers le contrôle serveur Web appelé à partir de cette méthode. Cette méthode est utilisée principalement par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_protmethodCreateChildControls()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Crée un contrôle enfant à l’aide de l’état d’affichage.(Hérité de BaseDataList.)

System_CAPS_protmethodCreateColumnSet(PagedDataSource, Boolean)

Crée le jeu de colonnes à utiliser pour générer la hiérarchie des contrôles. Lorsque AutoGenerateColumns a la valeur true, les colonnes sont créés pour correspondre à la source de données et sont ajoutées à l’ensemble des colonnes définies dans le Columns collection.

System_CAPS_protmethodCreateControlCollection()

Crée un objet ControlCollection objet pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.(Hérité de Control.)

System_CAPS_protmethodCreateControlHierarchy(Boolean)

Crée la hiérarchie des contrôles qui est utilisée pour restituer le DataGrid.(Remplace BaseDataList.CreateControlHierarchy(Boolean).)

System_CAPS_protmethodCreateControlStyle()

Crée un nouveau style de contrôle.(Remplace WebControl.CreateControlStyle().)

System_CAPS_protmethodCreateDataSourceSelectArguments()

Crée une valeur par défaut DataSourceSelectArguments objet utilisé par le contrôle lié aux données si aucun argument n’est spécifié.(Hérité de BaseDataList.)

System_CAPS_protmethodCreateItem(Int32, Int32, ListItemType)

Crée un objet DataGridItem.

System_CAPS_pubmethodDataBind()

Lie le contrôle et tous ses contrôles enfants à la source de données spécifiée.(Hérité de BaseDataList.)

System_CAPS_protmethodDataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher la DataBinding événement.(Hérité de Control.)

System_CAPS_protmethodDataBindChildren()

Lie une source de données à des contrôles enfants du contrôle serveur.(Hérité de Control.)

System_CAPS_pubmethodDispose()

Permet à un contrôle serveur effectuer de nettoyage final avant qu’il est libéré de la mémoire.(Hérité de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Se termine au moment du design le suivi des données de rendu.(Hérité de Control.)

System_CAPS_protmethodEnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. Si elle n’est pas le cas, il crée contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodEnsureDataBound()

Vérifie que les 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 le DataBind (méthode).(Hérité de BaseDataList.)

System_CAPS_protmethodEnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.(Hérité de Control.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

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

System_CAPS_pubmethodFindControl(String)

Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id paramètre.(Hérité de Control.)

System_CAPS_protmethodFindControl(String, Int32)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Recherche le conteneur d’attribution de noms actuel d’un contrôle serveur avec l’objet id et un entier, spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas substituer cette version de la FindControl méthode.(Hérité de Control.)

System_CAPS_pubmethodFocus()

Définit le focus à un contrôle.(Hérité de Control.)

System_CAPS_protmethodGetData()

Retourne un IEnumerable-objet qui représente la source de données.(Hérité de BaseDataList.)

System_CAPS_protmethodGetDesignModeState()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et un nom d’itinéraire.(Hérité de Control.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodHasControls()

Détermine si le contrôle serveur contient des contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodHasEvents()

Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou tous les contrôles enfants.(Hérité de Control.)

System_CAPS_protmethodInitializeItem(DataGridItem, DataGridColumn[])

Initialise le spécifié DataGridItem objet.

System_CAPS_protmethodInitializePager(DataGridItem, Int32, PagedDataSource)

Crée un DataGridItem objet qui contient l’interface utilisateur de pagination.

System_CAPS_protmethodIsLiteralContent()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Détermine si le contrôle serveur détient uniquement un contenu littéral.(Hérité de Control.)

System_CAPS_protmethodLoadControlState(Object)

Restaure les informations d’état du contrôle à partir d’une demande de page précédente enregistrée par la SaveControlState méthode.(Hérité de Control.)

System_CAPS_protmethodLoadViewState(Object)

Charge un état enregistré de le DataGrid.(Remplace WebControl.LoadViewState(Object).)

System_CAPS_protmethodMapPathSecure(String)

Récupère le chemin d’accès physique correspondant à un chemin d’accès virtuel, absolu ou relatif.(Hérité de Control.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodMergeStyle(Style)

Copie tous les éléments non vides du style spécifié sur le Web contrôlent, mais ne remplacement pas les éléments de style existants du contrôle. Cette méthode est utilisée principalement par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Passe l’événement déclenché par un contrôle dans le conteneur de la hiérarchie de contrôle de serveur de l’interface utilisateur de la page.(Remplace Control.OnBubbleEvent(Object, EventArgs).)

System_CAPS_protmethodOnCancelCommand(DataGridCommandEventArgs)

Déclenche l'événement CancelCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnDataBinding(EventArgs)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Déclenche la DataBinding événements d’un BaseDataList contrôle.(Hérité de BaseDataList.)

System_CAPS_protmethodOnDataPropertyChanged()

Appelé lorsque l’une des propriétés de d’identification de base de données source est modifiée, pour relier le contrôle lié aux données à ses données.(Hérité de BaseDataList.)

System_CAPS_protmethodOnDataSourceViewChanged(Object, EventArgs)

Déclenche l'événement DataSourceViewChanged.(Hérité de BaseDataList.)

System_CAPS_protmethodOnDeleteCommand(DataGridCommandEventArgs)

Déclenche l'événement DeleteCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnEditCommand(DataGridCommandEventArgs)

Déclenche l'événement EditCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnInit(EventArgs)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Déclenche l'événement Init pour le contrôle BaseDataList.(Hérité de BaseDataList.)

System_CAPS_protmethodOnItemCommand(DataGridCommandEventArgs)

Déclenche l'événement ItemCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnItemCreated(DataGridItemEventArgs)

Déclenche l'événement ItemCreated. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnItemDataBound(DataGridItemEventArgs)

Déclenche l'événement ItemDataBound. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnLoad(EventArgs)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Déclenche l'événement Load.(Hérité de BaseDataList.)

System_CAPS_protmethodOnPageIndexChanged(DataGridPageChangedEventArgs)

Déclenche l'événement PageIndexChanged. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnPreRender(EventArgs)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Déclenche l'événement PreRender.(Hérité de BaseDataList.)

System_CAPS_protmethodOnSelectedIndexChanged(EventArgs)

Déclenche la SelectedIndexChanged événements d’un BaseDataList contrôle.(Hérité de BaseDataList.)

System_CAPS_protmethodOnSortCommand(DataGridSortCommandEventArgs)

Déclenche l'événement SortCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOnUnload(EventArgs)

Déclenche l'événement Unload.(Hérité de Control.)

System_CAPS_protmethodOnUpdateCommand(DataGridCommandEventArgs)

Déclenche l'événement UpdateCommand. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.

System_CAPS_protmethodOpenFile(String)

Obtient un Stream utilisé pour lire un fichier.(Hérité de Control.)

System_CAPS_protmethodPrepareControlHierarchy()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit la hiérarchie des contrôles pour ce DataGrid contrôle.(Remplace BaseDataList.PrepareControlHierarchy().)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Assigne toute source de l’événement et ses informations au parent du contrôle.(Hérité de Control.)

System_CAPS_protmethodRemovedControl(Control)

Appelée après qu’un contrôle enfant est supprimé de la Controls collection de le Control objet.(Hérité de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Génère le rendu du contrôle via le writer HTML spécifié.(Hérité de BaseDataList.)

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

Restitue le code HTML balise d’ouverture de contrôle pour le writer spécifié. Cette méthode est utilisée principalement par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Renvoie le contenu des enfants d’un contrôle serveur à une collection HtmlTextWriter objet, qui écrit le contenu à rendre sur le client.(Hérité de Control.)

System_CAPS_protmethodRenderContents(HtmlTextWriter)

Restitue le contenu du contrôle sur le writer spécifié. Cette méthode est utilisée principalement par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter de l’objet et stocke les informations de traçage sur le contrôle si le traçage est activé.(Hérité de Control.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Renvoie le contenu du contrôle serveur à un HtmlTextWriter à l’aide d’un ControlAdapter objet.(Hérité de Control.)

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

Restitue le code HTML balise du contrôle de fermeture dans le writer spécifié. Cette méthode est utilisée principalement par les développeurs de contrôles.(Hérité de WebControl.)

System_CAPS_protmethodResolveAdapter()

Obtient l’adaptateur de contrôles responsable du rendu du contrôle spécifié.(Hérité de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.(Hérité de Control.)

System_CAPS_pubmethodResolveUrl(String)

Convertit une URL qui est utilisable sur le client demandeur.(Hérité de Control.)

System_CAPS_protmethodSaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.(Hérité de Control.)

System_CAPS_protmethodSaveViewState()

Enregistre l’état actuel de la DataGrid.(Remplace WebControl.SaveViewState().)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.(Hérité de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Assigne un délégué de gestionnaire d’événements pour afficher le contrôle de serveur et son contenu dans son contrôle parent.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Définit les données de conception suivi de données de rendu, à l’aide de l’objet de suivi, la clé de données de suivi et la valeur de données de suivi de trace.(Hérité de Control.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodTrackViewState()

Marque le point de départ pour commencer le suivi et l’enregistrement des modifications apportées au contrôle dans le cadre de l’état d’affichage de contrôle.(Remplace WebControl.TrackViewState().)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticCancelCommandName

Représente le Cancel nom de la commande. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticDeleteCommandName

Représente le nom de la commande Delete. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticEditCommandName

Représente le nom de la commande modifier. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticNextPageCommandArgument

Représente l’argument de commande suivant. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticPageCommandName

Représente le nom de commande de Page. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticPrevPageCommandArgument

Représente l’argument de la commande précédente. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticSelectCommandName

Représente le nom de la commande Select. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticSortCommandName

Représente le nom de commande de tri. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticUpdateCommandName

Représente le nom de commande de mise à jour. Ce champ est en lecture seule.

NomDescription
System_CAPS_pubeventCancelCommand

Se produit lorsque le Cancel bouton pour un élément dans le DataGrid contrôle.

System_CAPS_pubeventDataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.(Hérité de Control.)

System_CAPS_pubeventDeleteCommand

Se produit lorsque l’utilisateur clique sur le bouton Supprimer pour un élément dans le DataGrid contrôle.

System_CAPS_pubeventDisposed

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 serveur contrôle lorsqu’une page ASP.NET est demandée.(Hérité de Control.)

System_CAPS_pubeventEditCommand

Se produit lorsque l’utilisateur clique sur le bouton Modifier pour un élément dans le DataGrid contrôle.

System_CAPS_pubeventInit

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape du cycle de vie.(Hérité de Control.)

System_CAPS_pubeventItemCommand

Se produit lorsqu’un clic est effectué dans le DataGrid contrôle.

System_CAPS_pubeventItemCreated

Se produit sur le serveur lorsqu’un élément dans le DataGrid contrôle est créé.

System_CAPS_pubeventItemDataBound

Se produit après qu’un élément est lié aux données le DataGrid contrôle.

System_CAPS_pubeventLoad

Se produit lorsque le contrôle serveur est chargé dans le Page objet.(Hérité de Control.)

System_CAPS_pubeventPageIndexChanged

Se produit lorsque l’utilisateur clique sur un des éléments de sélection de page.

System_CAPS_pubeventPreRender

Se produit après le Control objet est chargé, mais avant le rendu.(Hérité de Control.)

System_CAPS_pubeventSelectedIndexChanged

Se produit lorsqu’un élément différent est sélectionné dans une liste de contrôle entre des publications sur le serveur de données.(Hérité de BaseDataList.)

System_CAPS_pubeventSortCommand

Se produit lorsqu’une colonne est triée.

System_CAPS_pubeventUnload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.(Hérité de Control.)

System_CAPS_pubeventUpdateCommand

Se produit lorsqu’un clic sur le bouton de mise à jour pour un élément dans le DataGrid contrôle.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient un attribut du contrôle Web avec le nom spécifié.(Hérité de WebControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

Définit un attribut du contrôle Web sur le nom spécifié et la valeur.(Hérité de WebControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions.(Hérité de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions.(Hérité de Control.)

NomDescription
System_CAPS_pubmethodEnableDynamicData(Type)

Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié.(Défini par DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, IDictionary<String, Object>)

Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié.(Défini par DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, Object)

Surchargé. Active le comportement Dynamic Data pour le contrôle de données spécifié.(Défini par DataControlExtensions.)

System_CAPS_pubmethodFindDataSourceControl()

Retourne la source de données qui est associée au contrôle de données pour le contrôle spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retourne que le modèle de champ pour la colonne spécifiée dans le contrôle spécifié du conteneur de dénomination.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retourne l’objet metatable pour le contrôle de données conteneur.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Surchargé. Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Surchargé. Obtient les métadonnées de table pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable)

Surchargé. Définit les métadonnées de table pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, IDictionary<String, Object>)

Surchargé. Définit le mappage table de valeurs par défaut et les métadonnées pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, Object)

Surchargé. Définit le mappage table de valeurs par défaut et les métadonnées pour le contrôle de données spécifié.(Défini par DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Surchargé. Détermine si les métadonnées de la table sont disponible.(Défini par DynamicDataExtensions.)

In this topic:

  • Introduction

  • Accessibility

  • Declarative Syntax

    System_CAPS_noteRemarque

    Before you use the T:System.Web.UI.WebControls.DataGrid control, consider using the T:System.Web.UI.WebControls.GridView control instead. The T:System.Web.UI.WebControls.GridView control, which was introduced in the .NET Framework version 2.0, is the successor to the T:System.Web.UI.WebControls.DataGrid control.

Use the T:System.Web.UI.WebControls.DataGrid control to display the fields of a data source as columns in a table. Each row in the T:System.Web.UI.WebControls.DataGrid control represents a record in the data source. The T:System.Web.UI.WebControls.DataGrid control supports selection, editing, deleting, paging, and sorting.

System_CAPS_cautionAttention

This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see Validation Server Control Syntax.

Different column types determine the behavior of the columns in the control. The following table lists the different column types that can be used.

Column Type

Description

BoundColumn

Displays a column bound to a field in a data source. It displays each item in the field as text. This is the default column type of the T:System.Web.UI.WebControls.DataGrid control.

ButtonColumn

Displays a command button for each item in the column. This allows you to create a column of custom button controls, such as Add or Remove buttons.

EditCommandColumn

Displays a column that contains editing commands for each item in the column.

HyperLinkColumn

Displays the contents of each item in the column as a hyperlink. The contents of the column can be bound to a field in a data source or static text.

TemplateColumn

Displays each item in the column following a specified template. This allows you to provide custom controls in the column.

By default, the P:System.Web.UI.WebControls.DataGrid.AutoGenerateColumns property is set to true, which creates a T:System.Web.UI.WebControls.BoundColumn object for each field in the data source. Each field is then rendered as a column in the T:System.Web.UI.WebControls.DataGrid control in the order that each field appears in the data source.

You can also manually control which columns appear in the T:System.Web.UI.WebControls.DataGrid control by setting the P:System.Web.UI.WebControls.DataGrid.AutoGenerateColumns property to false and then listing the columns that you want to include between the opening and closing <Columns> tags. The columns specified are added to the P:System.Web.UI.WebControls.DataGrid.Columns collection in the order listed. This allows you to programmatically control the columns in the T:System.Web.UI.WebControls.DataGrid control.

System_CAPS_noteRemarque

The order that the columns are displayed in the T:System.Web.UI.WebControls.DataGrid control is controlled by the order that the columns appear in the P:System.Web.UI.WebControls.DataGrid.Columns collection. Although you can programmatically change the order of the columns by manipulating the P:System.Web.UI.WebControls.DataGrid.Columns collection, it is easier to list the columns in the desired display order.

Explicitly declared columns can be displayed in conjunction with automatically generated columns. When using both, explicitly declared columns will be rendered first, followed by the automatically generated columns.

System_CAPS_noteRemarque

Automatically generated columns are not added to the P:System.Web.UI.WebControls.DataGrid.Columns collection.

The appearance of the T:System.Web.UI.WebControls.DataGrid control may be customized by setting the style properties for the different parts of the control. The following table lists the different style properties.

Style Property

Description

AlternatingItemStyle

Specifies the style for alternating items in the T:System.Web.UI.WebControls.DataGrid control.

EditItemStyle

Specifies the style for the item being edited in the T:System.Web.UI.WebControls.DataGrid control.

FooterStyle

Specifies the style for the footer section in the T:System.Web.UI.WebControls.DataGrid control.

HeaderStyle

Specifies the style for the header section in the T:System.Web.UI.WebControls.DataGrid control.

ItemStyle

Specifies the style for the items in the T:System.Web.UI.WebControls.DataGrid control.

PagerStyle

Specifies the style for the page selection section of the T:System.Web.UI.WebControls.DataGrid control.

SelectedItemStyle

Specifies the style for the selected item in the T:System.Web.UI.WebControls.DataGrid control.

You can also show or hide different parts of the control. The following table lists the properties that control which parts are shown or hidden.

Property

Description

ShowFooter

Shows or hides the footer section of the T:System.Web.UI.WebControls.DataGrid control.

ShowHeader

Shows or hides the header section of the T:System.Web.UI.WebControls.DataGrid control.

You can control the appearance of the T:System.Web.UI.WebControls.DataGrid control by programmatically adding attributes to the <td> and <tr> tags rendered by the control on the browser. Attributes can be programmatically added by providing code in the event handler for the M:System.Web.UI.WebControls.DataGrid.OnItemCreated(System.Web.UI.WebControls.DataGridItemEventArgs) or M:System.Web.UI.WebControls.DataGrid.OnItemDataBound(System.Web.UI.WebControls.DataGridItemEventArgs) event.

To add an attribute to the <td> tag, first get the T:System.Web.UI.WebControls.TableCell object that represents the cell in the T:System.Web.UI.WebControls.DataGrid control you want to add the attribute to. The P:System.Web.UI.Control.Controls collection for the P:System.Web.UI.WebControls.DataGridItemEventArgs.Item property of the T:System.Web.UI.WebControls.DataGridItemEventArgs object passed into the event handler can be used to get the desired T:System.Web.UI.WebControls.TableCell object. You can then use the M:System.Web.UI.AttributeCollection.Add(System.String,System.String) method of the P:System.Web.UI.WebControls.WebControl.Attributes collection for the T:System.Web.UI.WebControls.TableCell object to add attributes to the <td> tag.

To add an attribute to the <tr> tag, first get the T:System.Web.UI.WebControls.DataGridItem object that represents the row in the T:System.Web.UI.WebControls.DataGrid control you want to add the attribute to. The P:System.Web.UI.WebControls.DataGridItemEventArgs.Item property of the T:System.Web.UI.WebControls.DataGridItemEventArgs object passed into the event handler can be used to get the desired T:System.Web.UI.WebControls.DataGridItem object. You can then use the M:System.Web.UI.AttributeCollection.Add(System.String,System.String) method of the P:System.Web.UI.WebControls.WebControl.Attributes collection for the T:System.Web.UI.WebControls.DataGridItem object to add attributes to the <tr> tag.

For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio 2010 and ASP.NET 4 and ASP.NET Controls and Accessibility.

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

A Visual Studio Web site project with source code is available to accompany this topic: Downloadhttp://code.msdn.microsoft.com/Project/Download/FileDownload.aspx?ProjectName=aspnetmsdnexamples&DownloadId=11217.

The following code example demonstrates how to use the T:System.Web.UI.WebControls.DataGrid control to display the items in the data source.

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

The following code example demonstrates how to use the T:System.Web.UI.WebControls.DataGrid control for a simple shopping cart.

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

The following code example demonstrates how to dynamically add attributes to the <td> and <tr> tags generated by the T:System.Web.UI.WebControls.DataGrid control.


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


<%@ 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, ref int 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
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: