DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Metoda

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Poskytuje základní implementaci pro resetování zadané buňky ze sloupce odvozeného z DataGridColumn třídy do původního stavu.

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)

Parametry

cell

TableCell

A TableCell , který představuje buňku, která se má resetovat.

columnIndex

Int32

Číslo sloupce, ve kterém je buňka umístěná.

itemType

ListItemType

Jedna z ListItemType hodnot.

Poznámky

Metoda InitializeCell poskytuje základní implementaci pro resetování zadané buňky ze sloupce odvozeného z DataGridColumn třídy do počátečního stavu. Tato metoda není volána přímo. Místo toho je tato metoda zděděna odvozenou třídou sloupce, která lze použít k resetování buňky ve sloupci odvozeného typu. Volitelně můžete tuto metodu přepsat v odvozené třídě a poskytnout vlastní inicializační rutinu. Tato základní implementace InitializeCell metody je často volána z přepsáné metody k resetování vlastností společné pro všechny buňky ve sloupcích odvozených z DataGridColumn třídy.

V této implementaci InitializeCell metoda resetuje pouze buňky záhlaví a zápatí. Touto metodou nejsou ovlivněny jiné typy buněk.

Pokud je řazení povoleno (nastavením AllowSorting vlastnosti na true), LinkButton ovládací prvek se ve výchozím nastavení přidá do buňky záhlaví. To vám umožní seřadit sloupec po kliknutí na LinkButton ovládací prvek. Pokud pro buňku záhlaví zadáte obrázek (nastavením HeaderImageUrl vlastnosti), ImageButton vytvoří se místo toho ovládací prvek.

Při zakázání řazení se text zadaný HeaderText vlastností zobrazí v buňce záhlaví. Pokud zadáte obrázek buňky záhlaví (nastavením HeaderImageUrl vlastnosti), Image přidá se do buňky záhlaví ovládací prvek.

Vzhledem k tomu, že prohlížeč nezobrazí prázdnou buňku, pokud se v buňce záhlaví nezobrazí obrázek a HeaderText vlastnost není nastavená, zobrazí se v buňce záhlaví nerušující mezera HTML ( ). Podobně platí, že pokud buňka zápatí nemá žádný obsah (pokud FooterText vlastnost není nastavena), zobrazí se v buňce zápatí nerušující mezera HTML.

Poznámka:

Tuto metodu běžně používají vývojáři ovládacích prvků.