DataGridColumn.InitializeCell メソッド

DataGridColumn クラスから派生した列の指定したセルをその初期値にリセットする基本の実装を提供します。

Public Overridable Sub InitializeCell( _
   ByVal cell As TableCell, _   ByVal columnIndex As Integer, _   ByVal itemType As ListItemType _)
[C#]
public virtual void InitializeCell(TableCellcell,intcolumnIndex,ListItemTypeitemType);
[C++]
public: virtual void InitializeCell(TableCell* cell,intcolumnIndex,ListItemTypeitemType);
[JScript]
public function InitializeCell(
   cell : TableCell,columnIndex : int,itemType : ListItemType);

パラメータ

• cell
  リセットするセルを表す TableCell 。
• columnIndex
  セルが位置する列番号。
• itemType
  ListItemType 値の 1 つ。

解説

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

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

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

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

ブラウザは空のセルは表示しないため、ヘッダー セルにイメージが表示されず、 HeaderText プロパティも設定されていない場合、ヘッダー セルには改行なしの空白を表す HTML エンティティ ( ) が表示されます。同様に、 FooterText プロパティが設定されていないため、フッター セルに内容がない場合は、フッター セルに改行なしの空白を表す HTML エンティティが表示されます。

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

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

DataGridColumn クラス | DataGridColumn メンバ | System.Web.UI.WebControls 名前空間