DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.dll

Udostępnia implementację podstawową, aby zresetować określoną komórkę z kolumny pochodzącej z klasy do stanu początkowego DataGridColumn .

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

Element TableCell reprezentujący komórkę do zresetowania.

columnIndex

Int32

Numer kolumny, w której znajduje się komórka.

itemType

ListItemType

Jedna z ListItemType wartości.

Uwagi

Metoda InitializeCell udostępnia implementację podstawową, aby zresetować określoną komórkę z kolumny pochodzącej z klasy do stanu początkowego DataGridColumn . Ta metoda nie jest wywoływana bezpośrednio. Zamiast tego ta metoda jest dziedziczona przez klasę kolumn pochodnych, która następnie może służyć do resetowania komórki w kolumnie typu pochodnego. Opcjonalnie można zastąpić tę metodę w klasie pochodnej, aby zapewnić niestandardową procedurę inicjowania. Ta podstawowa implementacja InitializeCell metody jest często wywoływana z metody przesłoniętej w celu zresetowania właściwości wspólnych dla wszystkich komórek w kolumnach pochodzących z DataGridColumn klasy.

W tej implementacji InitializeCell metoda resetuje tylko komórki nagłówka i stopki. Inne typy komórek nie mają wpływu na tę metodę.

Po włączeniu AllowSorting sortowania (przez ustawienie właściwości na true), LinkButton domyślnie do komórki nagłówka jest dodawana kontrolka. Umożliwia to sortowanie kolumny po kliknięciu kontrolki LinkButton . Jeśli określisz obraz dla komórki nagłówka (ustawiając HeaderImageUrl właściwość), zamiast tego zostanie utworzona kontrolka ImageButton .

Po wyłączeniu sortowania tekst określony przez HeaderText właściwość jest wyświetlany w komórce nagłówka. Jeśli określisz obraz dla komórki nagłówka (ustawiając HeaderImageUrl właściwość), Image do komórki nagłówka zostanie dodana kontrolka.

Ponieważ przeglądarka nie wyświetli pustej komórki, jeśli obraz nie jest wyświetlany w komórce nagłówka, a HeaderText właściwość nie jest ustawiona, w komórce nagłówka jest wyświetlana niełamająca się przestrzeń  (). Podobnie, jeśli komórka stopki nie ma żadnej zawartości (jeśli FooterText właściwość nie jest ustawiona), w komórce stopki jest wyświetlana niełamająca się spacja jednostka HTML.

Uwaga

Ta metoda jest często używana przez deweloperów kontrolek.