DataControlRowState 列挙型

定義

public enum class DataControlRowState

[System.Flags]
public enum DataControlRowState

[<System.Flags>]
type DataControlRowState = 

Public Enum DataControlRowState

継承

Object

ValueType

Enum

DataControlRowState

属性

FlagsAttribute

フィールド

例

次の例では、 列挙を使用 DataControlRowState して、コントロール内の行の状態に基づいてユーザー インターフェイス (UI) をレンダリングする方法を GridView 示します。 このクラスは RadioButtonField 、コントロールから CheckBoxField 派生したユーザー設定フィールド コントロールであり、コントロール内のすべての行に対してデータ バインドラジオ ボタンを GridView レンダリングします。 行がユーザーにデータを表示していて、編集モードでない場合、 RadioButton コントロールは無効になります。 ユーザーが で GridView 行を更新し、その行が編集モードの場合、 RadioButton コントロールは有効としてレンダリングされ、クリックできるようになります。 この例では、行の状態が 1 つ以上 DataControlRowState の値の組み合わせである可能性があるため、ビットごとの AND 演算子を使用します。 この例は、 クラスに対して提供される大きな例の DataControlField 一部です。

// 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);
}

' 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

注釈

列挙型はDataControlRowState、 や GridViewなどのDetailsViewデータ コントロール内の行の状態を識別します。 行の状態は値の DataControlRowState 1 つまたは組み合わせにすることができます。そのため、ビットごとの演算を使用して、行の状態に等価性テストではなく値が含まれている DataControlRowState かどうかを判断します。 列挙は DataControlRowState 、行だけでなく DataRow 任意の種類の行に使用されます (通常、ヘッダー行とフッター行の状態は に Normal設定されます)。

列挙をDataControlRowState使用して、 または コレクションを列挙DetailsViewRowCollectionGridViewRowCollectionするときに、 オブジェクトまたは DetailsViewRow オブジェクトのGridViewRow状態をそれぞれ識別できます。 行を使用するデータ コントロールを記述する場合は、 列挙を DataControlRowState 使用して、行 (値) に対して異なる色をレンダリングするタイミング、または行の Alternate 編集に対して有効または無効になっているコントロール ( Edit および Insert 値) を識別できます。

適用対象

こちらもご覧ください

• DetailsViewRow
• GridViewRow
• DataControlRowType