DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Methode

  • Referenz

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.

Gilt für: