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 實體。

注意

控制項開發人員通常會使用這個方法。