DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt die Basisimplementierung bereit, um die angegebene Zelle aus einer Spalte zurückzusetzen, die von der DataGridColumn Klasse abgeleitet wurde, auf den Anfangszustand.
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 -> unitPublic Overridable Sub InitializeCell (cell As TableCell, columnIndex As Integer, itemType As ListItemType)Parameter
- columnIndex
- Int32
Die Spaltennummer, in der sich die Zelle befindet.
- itemType
- ListItemType
Einer der ListItemType Werte.
Hinweise
Die InitializeCell Methode stellt die Basisimplementierung bereit, um die angegebene Zelle von einer Spalte zurückzusetzen, die von der DataGridColumn Klasse auf den Anfangszustand abgeleitet ist. Diese Methode wird nicht direkt aufgerufen. Stattdessen wird diese Methode von einer abgeleiteten Spaltenklasse geerbt, die dann zum Zurücksetzen einer Zelle in der Spalte des abgeleiteten Typs verwendet werden kann. 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 Spalten zugeordnet sind, die von der DataGridColumn Klasse abgeleitet 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 standardmäßig ein LinkButton Steuerelement zur Kopfzeilenzelle hinzugefügt. Auf diese Weise können Sie die Spalte sortieren, wenn auf das LinkButton Steuerelement geklickt wird. Wenn Sie ein Bild für die Kopfzeilenzelle angeben (durch Festlegen der HeaderImageUrl Eigenschaft), wird stattdessen ein ImageButton Steuerelement erstellt.
Wenn die Sortierung deaktiviert ist, wird der durch die HeaderText Eigenschaft angegebene Text in der Kopfzeilenzelle angezeigt. Wenn Sie ein Bild für die Kopfzeilenzelle angeben (durch Festlegen der HeaderImageUrl Eigenschaft), wird der Kopfzeilenzelle ein Image Steuerelement hinzugefügt.
Da in einem Browser keine leere Zelle angezeigt wird, wird in der Kopfzeilenzelle HeaderText eine nicht geschützte Leerzeichen-HTML-Entität ( ) in der Kopfzeilenzelle angezeigt. Wenn die Fußzeilenzelle keinen Inhalt aufweist (wenn die FooterText Eigenschaft nicht festgelegt ist), wird in der Fußzeilenzelle eine geschützte Leerzeichen-HTML-Entität angezeigt.
Hinweis
Diese Methode wird häufig von Steuerelemententwicklern verwendet.
