DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Methode

Definitie

Biedt de basis-implementatie om de opgegeven cel opnieuw in te stellen van een kolom die is afgeleid van de klasse in de DataGridColumn beginstatus.

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)

Parameters

cell
TableCell

Een TableCell die de cel weergeeft die opnieuw moet worden ingesteld.

columnIndex
Int32

Het kolomnummer waar de cel zich bevindt.

itemType
ListItemType

Een van de ListItemType waarden.

Opmerkingen

De InitializeCell methode biedt de basis-implementatie om de opgegeven cel opnieuw in te stellen van een kolom die is afgeleid van de klasse in de DataGridColumn oorspronkelijke status. Deze methode wordt niet rechtstreeks aangeroepen. In plaats daarvan wordt deze methode overgenomen door een afgeleide kolomklasse, die vervolgens kan worden gebruikt om een cel in de kolom van het afgeleide type opnieuw in te stellen. U kunt deze methode desgewenst overschrijven in de afgeleide klasse om een aangepaste initialisatieroutine te bieden. Deze basisuitvoering van de InitializeCell methode wordt vaak aangeroepen vanuit de overschreven methode om eigenschappen die gemeenschappelijk zijn voor alle cellen in kolommen die zijn afgeleid van de DataGridColumn klasse, opnieuw in te stellen.

In deze implementatie InitializeCell worden alleen de kop- en voettekstcellen opnieuw ingesteld. Andere typen cellen worden niet beïnvloed door deze methode.

Wanneer sorteren is ingeschakeld (door de AllowSorting eigenschap in te truestellen), wordt standaard een LinkButton besturingselement toegevoegd aan de koptekstcel. Hiermee kunt u de kolom sorteren wanneer op het LinkButton besturingselement wordt geklikt. Als u een afbeelding opgeeft voor de koptekstcel (door de HeaderImageUrl eigenschap in te stellen), wordt in plaats daarvan een ImageButton besturingselement gemaakt.

Wanneer sorteren is uitgeschakeld, wordt de tekst die door de HeaderText eigenschap is opgegeven, weergegeven in de koptekstcel. Als u een afbeelding opgeeft voor de koptekstcel (door de HeaderImageUrl eigenschap in te stellen), wordt er een Image besturingselement toegevoegd aan de koptekstcel.

Omdat een browser geen lege cel weergeeft, wordt er een niet-brekende HTML-entiteit (HeaderText) weergegeven in de koptekstcel als er geen afbeelding wordt weergegeven in de koptekstcel en de   eigenschap niet is ingesteld. Als de voettekstcel geen inhoud heeft (als de FooterText eigenschap niet is ingesteld), wordt er ook een vaste ruimte-HTML-entiteit weergegeven in de voettekstcel.

Note

Deze methode wordt vaak gebruikt door controleontwikkelaars.

Van toepassing op