DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Méthode

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Fournit l'implémentation de base permettant de réinitialiser l'état de la cellule spécifiée à partir d'une colonne dérivée de la classe DataGridColumn.

public:
 virtual void InitializeCell(System::Web::UI::WebControls::TableCell ^ cell, int columnIndex, System::Web::UI::WebControls::ListItemType itemType);

public virtual void InitializeCell (System.Web.UI.WebControls.TableCell cell, int columnIndex, System.Web.UI.WebControls.ListItemType itemType);

abstract member InitializeCell : System.Web.UI.WebControls.TableCell * int * System.Web.UI.WebControls.ListItemType -> unit
override this.InitializeCell : System.Web.UI.WebControls.TableCell * int * System.Web.UI.WebControls.ListItemType -> unit

Public Overridable Sub InitializeCell (cell As TableCell, columnIndex As Integer, itemType As ListItemType)

Paramètres

cell

TableCell

TableCell représentant la cellule à réinitialiser.

columnIndex

Int32

Numéro de la colonne dans laquelle la cellule se trouve.

itemType

ListItemType

Une des valeurs de l'objet ListItemType.

Remarques

La InitializeCell méthode fournit l’implémentation de base pour réinitialiser la cellule spécifiée à partir d’une colonne dérivée de la DataGridColumn classe à son état initial. Cette méthode n'est pas directement appelée. Au lieu de cela, cette méthode est héritée par une classe de colonne dérivée, qui peut ensuite être utilisée pour réinitialiser une cellule dans la colonne du type dérivé. Vous pouvez éventuellement remplacer cette méthode dans la classe dérivée pour fournir une routine d’initialisation personnalisée. Cette implémentation de base de la InitializeCell méthode est souvent appelée à partir de la méthode remplacée pour réinitialiser les propriétés communes à toutes les cellules dans les colonnes dérivées de la DataGridColumn classe .

Dans cette implémentation, la InitializeCell méthode réinitialise uniquement les cellules d’en-tête et de pied de page. D’autres types de cellules ne sont pas affectés par cette méthode.

Lorsque le tri est activé (en définissant la AllowSorting propriété sur true), un LinkButton contrôle est ajouté à la cellule d’en-tête par défaut. Cela vous permet de trier la colonne lorsque vous cliquez sur le LinkButton contrôle. Si vous spécifiez une image pour la cellule d’en-tête (en définissant la HeaderImageUrl propriété), un ImageButton contrôle est créé à la place.

Lorsque le tri est désactivé, le texte spécifié par la HeaderText propriété s’affiche dans la cellule d’en-tête. Si vous spécifiez une image pour la cellule d’en-tête (en définissant la HeaderImageUrl propriété), un Image contrôle est ajouté à la cellule d’en-tête.

Étant donné qu’un navigateur n’affiche pas de cellule vide, si une image dans n’est pas affichée dans la cellule d’en-tête et que la HeaderText propriété n’est pas définie, une entité HTML d’espace non cassante ( ) s’affiche dans la cellule d’en-tête. De même, si la cellule pied de page n’a pas de contenu (si la FooterText propriété n’est pas définie), une entité HTML d’espace non cassante s’affiche dans la cellule pied de page.

Notes

Cette méthode est couramment utilisée par les développeurs de contrôles.