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

Определение

Предоставляет базовую реализацию для сброса указанной ячейки из столбца, полученного из класса DataGridColumn, в исходное состояние.Provides the base implementation to reset the specified cell from a column derived from the DataGridColumn class to its initial state.

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, представляющий ячейку, которую необходимо сбросить.A TableCell that represents the cell to reset.

columnIndex
Int32

Номер столбца, в котором расположена ячейка.The column number where the cell is located.

itemType
ListItemType

Одно из значений ListItemType.One of the ListItemType values.

Комментарии

Метод InitializeCell предоставляет базовую реализацию для сброса указанной ячейки из столбца, производного от класса DataGridColumn, в исходное состояние.The InitializeCell method provides the base implementation to reset the specified cell from a column derived from the DataGridColumn class to its initial state. Этот метод непосредственно не вызывается.This method is not called directly. Вместо этого этот метод наследуется классом производного столбца, который затем можно использовать для сброса ячейки в столбце производного типа.Instead, this method is inherited by a derived column class, which can then be used to reset a cell in the column of the derived type. При необходимости можно переопределить этот метод в производном классе, чтобы предоставить настраиваемую подпрограммы инициализации.You can optionally override this method in the derived class to provide a custom initialization routine. Эта базовая реализация InitializeCell метод часто вызывается из переопределенного метода для сброса свойствами, общими для всех типов столбцов, производным от DataGridColumn класса.This base implementation of the InitializeCell method is often called from the overridden method to reset properties common to all cells in columns derived from the DataGridColumn class.

В данном случае InitializeCell метод восстанавливает только ячейки верхнего и нижнего колонтитулов.In this implementation, the InitializeCell method resets only the header and footer cells. Этот метод не влияет на другие типы ячеек.Other types of cells are not affected by this method.

Если сортировка включена (задавая AllowSorting свойства true), LinkButton элемент управления добавляется в ячейку заголовка по умолчанию.When sorting is enabled (by setting the AllowSorting property to true), a LinkButton control is added to the header cell by default. Это позволяет отсортировать столбец при LinkButton нажатии элемента управления.This allows you to sort the column when the LinkButton control is clicked. Если указать изображение для ячейки заголовка (задавая HeaderImageUrl свойство), ImageButton вместо этого создается элемент управления.If you specify an image for the header cell (by setting the HeaderImageUrl property), an ImageButton control is created instead.

Если сортировка отключена, текст, заданный параметром HeaderText свойство отображается в ячейке заголовка.When sorting is disabled, the text specified by the HeaderText property is displayed in the header cell. Если указать изображение для ячейки заголовка (задавая HeaderImageUrl свойство), Image элемент управления добавляется в ячейку заголовка.If you specify an image for the header cell (by setting the HeaderImageUrl property), an Image control is added to the header cell.

Так как браузер не отображает пустую ячейку, если изображение в не отображается в ячейке заголовка и HeaderText свойство не задано, неразрывный пробел сущности HTML ( ) отображается в ячейке заголовка.Because a browser will not display an empty cell, if an image in not displayed in the header cell and the HeaderText property is not set, a nonbreaking space HTML entity ( ) is displayed in the header cell. Аналогично, если ячейка нижнего колонтитула не имеет содержимого (если свойство FooterText не задано), то в ячейке нижнего колонтитула отображается HTML-сущность неразрывного пространства.Similarly, if the footer cell does not have any content (if the FooterText property is not set), a nonbreaking space HTML entity is displayed in the footer cell.

Примечание

Этот метод обычно используется разработчиками элементов управления.This method is commonly used by control developers.

Применяется к