DataControlField.InitializeCell メソッド

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

DataControlField.InitializeCell メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

セルのコントロールのコレクションにテキストまたはコントロールを追加します。

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

Visual Basic (宣言)

Public Overridable Sub InitializeCell
 ( _
    cell As DataControlFieldCell, _
    cellType As DataControlCellType, _
    rowState As DataControlRowState, _
    rowIndex As Integer _
)

Visual Basic (使用法)

Dim instance As DataControlField
Dim cell As DataControlFieldCell
Dim cellType As DataControlCellType
Dim rowState As DataControlRowState
Dim rowIndex As Integer

instance.InitializeCell(cell, cellType, rowState, rowIndex)

C#

public virtual void InitializeCell (
    DataControlFieldCell cell,
    DataControlCellType cellType,
    DataControlRowState rowState,
    int rowIndex
)

C++

public:
virtual void InitializeCell (
    DataControlFieldCell^ cell, 
    DataControlCellType cellType, 
    DataControlRowState rowState, 
    int rowIndex
)

J#

public void InitializeCell (
    DataControlFieldCell cell, 
    DataControlCellType cellType, 
    DataControlRowState rowState, 
    int rowIndex
)

JScript

public function InitializeCell (
    cell : DataControlFieldCell, 
    cellType : DataControlCellType, 
    rowState : DataControlRowState, 
    rowIndex : int
)

パラメータ

cell

DataControlField のテキストまたはコントロールを格納する DataControlFieldCell。

cellType

DataControlCellType 値の 1 つ。

rowState

DataControlRowState 値の 1 つ。DataControlFieldCell を格納する行の状態を示します。

rowIndex

DataControlFieldCell を含む行のインデックス。

解説

DataControlField から派生した型は、InitializeCell メソッドを実装して、テーブルを使用してユーザー インターフェイス (UI: User Interface) を表示するデータ コントロールに属する DataControlFieldCell オブジェクトにテキストとコントロールを追加します。これらのデータ コントロールは、そのコントロールの個別の CreateChildControls メソッドを呼び出すたびに、完全なテーブル構造を 1 行ずつ作成します。InitializeCell メソッドは、DetailsView や GridView などのデータ コントロールの InitializeRow メソッドにより呼び出されます。

このメソッドは、DataControlFieldCell オブジェクトを使用するカスタム データ バインド コントロールを記述して、テーブル構造のセルをデータまたはコントロールで初期化するときに呼び出します。このメソッドは、DataControlField から派生したクラスを記述する場合に実装します。

使用例

DataControlField クラスから派生したコントロールの InitializeCell メソッドを実装する方法を次のコード例に示します。RadioButtonField クラスは、GridView コントロールの各行にデータ バインド オプション ボタンを表示します。行がデータを表示していて、さらに編集モードでない場合、RadioButton コントロールは無効になります。ユーザーが GridView コントロール内の行の更新を選択した場合のように行が編集モードの場合、RadioButton コントロールが有効化されて表示され、クリックできるようになります。この例ではビットごとの AND 演算子を使用しています。これは、行の状態が 1 つ以上の DataControlRowState 値の組み合わせで決まるからです。

Visual Basic

' This method adds a RadioButton control and any other 
' content to the cell's Controls collection.
Protected Overrides Sub
 InitializeDataCell( _
    ByVal cell As DataControlFieldCell, _
    ByVal rowState As DataControlRowState)

    Dim radio As New RadioButton()

    ' If the RadioButton is bound to a DataField, add
    ' the OnDataBindingField method event handler to the
    ' DataBinding event.
    If DataField.Length <> 0 Then
        AddHandler radio.DataBinding, AddressOf
 Me.OnDataBindField
    End If

    radio.Text = Me.Text

    ' Because the RadioButtonField is a BoundField, it only 
    ' displays data. Therefore, unless the row is in edit mode, 
    ' the RadioButton is displayed as disabled.
    radio.Enabled = False
    ' If the row is in edit mode, enable the button.
    If (rowState And DataControlRowState.Edit)
 <> 0 _
        OrElse (rowState And DataControlRowState.Insert)
 <> 0 Then
        radio.Enabled = True
    End If

    cell.Controls.Add(radio)
End Sub

C#

// This method adds a RadioButton control and any other 
// content to the cell's Controls collection.
protected override void InitializeDataCell
    (DataControlFieldCell cell, DataControlRowState rowState) {

  RadioButton radio = new RadioButton();

  // If the RadioButton is bound to a DataField, add
  // the OnDataBindingField method event handler to the
  // DataBinding event.
  if (DataField.Length != 0) {
    radio.DataBinding += new EventHandler(this.OnDataBindField);
  }

  radio.Text = this.Text;

  // Because the RadioButtonField is a BoundField, it only
  // displays data. Therefore, unless the row is in edit mode,
  // the RadioButton is displayed as disabled.
  radio.Enabled = false;
  // If the row is in edit mode, enable the button.
  if ((rowState & DataControlRowState.Edit) != 0 ||
      (rowState & DataControlRowState.Insert) != 0) {
    radio.Enabled = true;
  }

  cell.Controls.Add(radio);
}

J#

// This method adds a RadioButton control and any other content to the
//cell's Controls collection.
protected void InitializeDataCell(DataControlFieldCell
 cell, 
    DataControlRowState rowState)
{
    RadioButton radio = new RadioButton();
    // If the RadioButton is bound to a DataField, add
    // the OnDataBindingField method event handler to the
    // DataBinding event.
    if (get_DataField().get_Length() != 0) {
        radio.add_DataBinding(new EventHandler(this.OnDataBindField));
    }
    radio.set_Text(this.get_Text());
    // Because the RadioButtonField is a BoundField, it only displays
 data. Therefore,
    // unless the row is in edit mode, the RadioButton is displayed
 as 
    // disabled.
    radio.set_Enabled(false);
    // If the row is in edit mode, enable the button.
    if (((int)(rowState & DataControlRowState.Edit)
 != 0) || ((int)(
        rowState & DataControlRowState.Insert) != 0)) {
        radio.set_Enabled(true);
    }
    cell.get_Controls().Add(radio);
} //InitializeDataCell

プラットフォーム

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

参照

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