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 ， 方法仅重置页眉和页脚单元格。 其他类型的单元格不受此方法的影响。

通过将 属性设置为 AllowSortingtrue) (启用排序时，默认情况下，将控件 LinkButton 添加到标题单元格。 这使你可以在单击控件时 LinkButton 对列进行排序。 如果通过设置 HeaderImageUrl) 属性为标题单元格 (指定图像，则会改为创建控件 ImageButton 。

禁用排序时，由 属性指定的 HeaderText 文本将显示在标题单元格中。 如果通过将 属性) HeaderImageUrl 为标题单元格 (指定图像，则会向标题单元格添加一个 Image 控件。

由于浏览器不会显示空单元格，因此，如果中的图像未显示在标题单元格中，并且 HeaderText 未设置 属性，则会在标题单元格中显示一个不间断空格 HTML 实体 ( ) 。 同样，如果页脚单元格没有任何内容 (如果未 FooterText) 设置属性，则页脚单元格中会显示一个不间断空格 HTML 实体。

注意

此方法通常由控件开发人员使用。