DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Methode

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Stellt die Basisimplementierung bereit, mit der die angegebene Zelle in einer von der DataGridColumn-Klasse abgeleiteten Spalte in ihren Ausgangszustand zurückgesetzt werden kann.

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)

Parameter

cell

TableCell

Eine TableCell, die die zurückzusetzende Zelle darstellt.

columnIndex

Int32

Die Nummer der Spalte, in der sich die Zelle befindet.

itemType

ListItemType

Einer der ListItemType-Werte.

Hinweise

Die InitializeCell -Methode stellt die Basisimplementierung bereit, um die angegebene Zelle aus einer von der -Klasse abgeleiteten Spalte auf den DataGridColumn Ursprünglichen Zustand zurückzusetzen. Diese Methode wird nicht direkt aufgerufen. Stattdessen wird diese Methode von einer abgeleiteten Spaltenklasse geerbt, die dann verwendet werden kann, um eine Zelle in der Spalte des abgeleiteten Typs zurückzusetzen. Sie können diese Methode optional in der abgeleiteten Klasse überschreiben, um eine benutzerdefinierte Initialisierungsroutine bereitzustellen. Diese Basisimplementierung der InitializeCell -Methode wird häufig von der überschriebenen Methode aufgerufen, um eigenschaften zurückzusetzen, die allen Zellen in von der DataGridColumn -Klasse abgeleiteten Spalten gemeinsam sind.

In dieser Implementierung setzt die InitializeCell Methode nur die Kopf- und Fußzeilenzellen zurück. Andere Zelltypen sind von dieser Methode nicht betroffen.

Wenn die Sortierung aktiviert ist (durch Festlegen der AllowSorting -Eigenschaft auf true), wird der Headerzelle standardmäßig ein LinkButton Steuerelement hinzugefügt. Dadurch können Sie die Spalte sortieren, wenn auf das LinkButton Steuerelement geklickt wird. Wenn Sie ein Bild für die Headerzelle angeben (indem Sie die HeaderImageUrl -Eigenschaft festlegen), wird stattdessen ein ImageButton Steuerelement erstellt.

Wenn die Sortierung deaktiviert ist, wird der durch die HeaderText -Eigenschaft angegebene Text in der Headerzelle angezeigt. Wenn Sie ein Bild für die Headerzelle angeben (durch Festlegen der HeaderImageUrl -Eigenschaft), wird der Headerzelle ein Image Steuerelement hinzugefügt.

Da ein Browser keine leere Zelle anzeigt, wird in der Kopfzeilenzelle ein Bild in nicht angezeigt und die HeaderText -Eigenschaft nicht festgelegt ist, in der Kopfzeilenzelle eine html-Entität mit unterbrechungsfreiem Leerzeichen ( ) angezeigt. Wenn die Fußzeilenzelle keinen Inhalt aufweist (wenn die Eigenschaft nicht festgelegt ist), wird in der FooterText Fußzeilenzelle eine HTML-Entität ohne Unterbrechung des Leerzeichens angezeigt.

Hinweis

Diese Methode wird häufig von Steuerelemententwicklern verwendet.