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 pour réinitialiser la cellule spécifiée d’une colonne dérivée de la DataGridColumn classe à son état initial.

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

Qui TableCell représente la cellule à réinitialiser.

columnIndex

Int32

Numéro de colonne où se trouve la cellule.

itemType

ListItemType

Une des ListItemType valeurs.

Remarques

La InitializeCell méthode fournit l’implémentation de base pour réinitialiser la cellule spécifiée d’une colonne dérivée de la DataGridColumn classe à son état initial. Cette méthode n’est pas appelée directement. 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 de la méthode substituée pour réinitialiser les propriétés communes à toutes les cellules des 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é truesur ), un LinkButton contrôle est ajouté à la cellule d’en-tête par défaut. Cela vous permet de trier la colonne lorsque le LinkButton contrôle est cliqué. Si vous spécifiez une image pour la cellule d’en-tête (en définissant la propriété), un ImageButton contrôle est créé à la HeaderImageUrl 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 ne s’affiche pas 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 ( ) est affichée dans la cellule d’en-tête. De même, si la cellule de pied de page n’a pas de contenu (si la FooterText propriété n’est pas définie), une entité HTML d’espace non décassante s’affiche dans la cellule de pied de page.

Note

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