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-сущность.

Примечание

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