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 値のいずれか 1 つ。

注釈

メソッドは InitializeCell 、クラスから派生した列から初期状態に指定されたセルを DataGridColumn リセットする基本実装を提供します。 このメソッドは直接には呼び出されません。 代わりに、このメソッドは派生列クラスによって継承され、これを使用して派生型の列のセルをリセットできます。 必要に応じて、派生クラスでこのメソッドをオーバーライドして、カスタム初期化ルーチンを提供できます。 メソッドの InitializeCell この基本実装は、クラスから派生した列のすべてのセルに共通するプロパティをリセットするために、オーバーライドされたメソッドから DataGridColumn 呼び出されることが多いです。

この実装では、 メソッドは InitializeCell ヘッダーセルとフッターセルのみをリセットします。 他の種類のセルは、このメソッドの影響を受けません。

並べ替えが有効になっている場合 (プロパティを AllowSorting に true設定することによって)、 LinkButton 既定ではコントロールがヘッダー セルに追加されます。 これにより、コントロールがクリックされたときに列を LinkButton 並べ替えることができます。 ヘッダー セルのイメージを (プロパティを設定 HeaderImageUrl して) ImageButton 指定すると、代わりにコントロールが作成されます。

並べ替えを無効にすると、 プロパティで HeaderText 指定されたテキストがヘッダー セルに表示されます。 (プロパティを設定して) ヘッダー セルのイメージを HeaderImageUrl 指定すると、 Image コントロールがヘッダー セルに追加されます。

ブラウザーには空のセルが表示されないため、 の画像がヘッダー セルに表示されず、 HeaderText プロパティが設定されていない場合は、ヘッダー セルに改行されていないスペース HTML エンティティ ( ) が表示されます。 同様に、フッター セルにコンテンツがない場合 (プロパティが設定されていない場合 FooterText )、改行されていないスペース HTML エンティティがフッター セルに表示されます。

Note

このメソッドは、コントロール開発者によって一般的に使用されます。