DataGridColumn.InitializeCell-Methode

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Sub InitializeCell ( _
    cell As TableCell, _
    columnIndex As Integer, _
    itemType As ListItemType _
)
'Usage
Dim instance As DataGridColumn
Dim cell As TableCell
Dim columnIndex As Integer
Dim itemType As ListItemType

instance.InitializeCell(cell, columnIndex, itemType)

public virtual void InitializeCell (
    TableCell cell,
    int columnIndex,
    ListItemType itemType
)

public:
virtual void InitializeCell (
    TableCell^ cell, 
    int columnIndex, 
    ListItemType itemType
)

public void InitializeCell (
    TableCell cell, 
    int columnIndex, 
    ListItemType itemType
)

public function InitializeCell (
    cell : TableCell, 
    columnIndex : int, 
    itemType : ListItemType
)

Parameter

• cell
  Eine TableCell, die die zurückzusetzende Zelle darstellt.

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

• itemType
  Einer der ListItemType-Werte.

Hinweise

Die InitializeCell-Methode stellt die Basisimplementierung bereit, mit der die angegebene Zelle in einer von der DataGridColumn-Klasse abgeleiteten Spalte auf ihren Ausgangszustand zurückgesetzt werden kann. Diese Methode wird nicht direkt aufgerufen. Stattdessen wird diese Methode von einer abgeleiteten Spaltenklasse geerbt, mit der dann eine Zelle in der Spalte vom abgeleiteten Typ zurückgesetzt werden kann. Wahlweise können Sie diese Methode in der abgeleiteten Klasse überschreiben, um eine benutzerdefinierte Initialisierungsroutine bereitzustellen. Diese Basisimplementierung der InitializeCell-Methode wird häufig in der überschriebenen Methode aufgerufen, um die gemeinsamen Eigenschaften aller Zellen zurückzusetzen, die sich in von der DataGridColumn-Klasse abgeleiteten Spalten befinden.

In dieser Implementierung setzt die InitializeCell-Methode nur die Kopf- und Fußzeilenzellen zurück. Für andere Zellentypen hat die Methode keine Auswirkungen.

Wenn die Sortierung (durch Festlegen der AllowSorting-Eigenschaft auf true) aktiviert ist, wird der Kopfzeilenzelle in der Standardeinstellung ein LinkButton-Steuerelement hinzugefügt. Dies ermöglicht es Ihnen, die Spalte durch Klicken auf das LinkButton-Steuerelement zu sortieren. Wenn Sie für die Kopfzeilenzelle (durch Festlegen der HeaderImageUrl-Eigenschaft) ein Bild angeben, wird hingegen ein ImageButton-Steuerelement erstellt.

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

Da Browser keine leeren Zellen anzeigen, wird in der Kopfzeilenzelle ein geschütztes Leerzeichen im HTML-Format ( ) angezeigt, wenn die Zelle kein Bild enthält und die HeaderText-Eigenschaft nicht festgelegt ist. Ebenso wird in der Fußzeilenzelle ein geschütztes Leerzeichen im HTML-Format angezeigt, wenn die Zelle keine Daten enthält (d. h., wenn die FooterText-Eigenschaft nicht festgelegt ist).

Hinweis

Diese Methode wird i. d. R. von Steuerelemententwicklern verwendet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DataGridColumn-Klasse
DataGridColumn-Member
System.Web.UI.WebControls-Namespace