DataGridColumn.InitializeCell メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridColumn.InitializeCell メソッド

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub InitializeCell
 ( _
    cell As TableCell, _
    columnIndex As Integer, _
    itemType As ListItemType _
)

Visual Basic (使用法)

Dim instance As DataGridColumn
Dim cell As TableCell
Dim columnIndex As Integer
Dim itemType As ListItemType

instance.InitializeCell(cell, columnIndex, itemType)

C#

public virtual void InitializeCell (
    TableCell cell,
    int columnIndex,
    ListItemType itemType
)

C++

public:
virtual void InitializeCell (
    TableCell^ cell, 
    int columnIndex, 
    ListItemType itemType
)

J#

public void InitializeCell (
    TableCell cell, 
    int columnIndex, 
    ListItemType itemType
)

JScript

public function InitializeCell (
    cell : TableCell, 
    columnIndex : int, 
    itemType : ListItemType
)

パラメータ

cell

リセットするセルを表す TableCell。

columnIndex

セルが位置する列番号。

itemType

ListItemType 値の 1 つ。

解説

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

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

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

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

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DataGridColumn クラス
DataGridColumn メンバ
System.Web.UI.WebControls 名前空間