DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Метод

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

Предоставляет базовую реализацию для сброса указанной ячейки из столбца, полученного 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)

Параметры

cell

TableCell

Объект, TableCell представляющий ячейку для сброса.

columnIndex

Int32

Номер столбца, в котором расположена ячейка.

itemType

ListItemType

Одно из значений ListItemType .

Комментарии

Метод InitializeCell предоставляет базовую реализацию для сброса указанной ячейки из столбца, производного от класса до начального DataGridColumn состояния. Этот метод не вызывается напрямую. Вместо этого этот метод наследуется производным классом столбцов, который затем можно использовать для сброса ячейки в столбце производного типа. Этот метод можно переопределить в производном классе, чтобы предоставить настраиваемую подпрограмму инициализации. Эта базовая реализация InitializeCell метода часто вызывается из переопределенного метода для сброса свойств, общих для всех ячеек в столбцах, производных от DataGridColumn класса.

В этой реализации InitializeCell метод сбрасывает только ячейки верхнего и нижнего колонтитула. Другие типы ячеек не влияют на этот метод.

Если сортировка включена (задав AllowSorting для свойства trueзначение), LinkButton элемент управления добавляется в ячейку заголовка по умолчанию. Это позволяет отсортировать столбец при щелчке LinkButton элемента управления. Если указать изображение для ячейки заголовка (задав HeaderImageUrl свойство), ImageButton вместо этого создается элемент управления.

При отключении сортировки текст, указанный HeaderText свойством, отображается в ячейке заголовка. Если указать изображение для ячейки заголовка (задав HeaderImageUrl свойство), элемент Image управления добавляется в ячейку заголовка.

Так как браузер не будет отображать пустую ячейку, если изображение не отображается в ячейке заголовка и HeaderText свойство не задано, в ячейке заголовка отображается неразрывное пространство HTML-сущности ( ). Аналогичным образом, если ячейка нижнего колонтитула не содержит содержимого (если FooterText свойство не задано), в ячейке нижнего колонтитула отображается неразрывная сущность HTML.

Замечание

Этот метод часто используется разработчиками элементов управления.