DataControlRowState DataControlRowState DataControlRowState DataControlRowState Enum

定義

DetailsView または GridView など、データ コントロールの行の状態を指定します。Specifies the state of a row in a data control, such as DetailsView or GridView.

この列挙型には FlagsAttribute 属性があり、メンバー値ではビットごとの組み合わせを使用できます。

public enum class DataControlRowState
[System.Flags]
public enum DataControlRowState
type DataControlRowState = 
Public Enum DataControlRowState
継承
DataControlRowStateDataControlRowStateDataControlRowStateDataControlRowState
属性

フィールド

Alternate Alternate Alternate Alternate 1

データ コントロール行が代替行であることを示します。Indicates that the data control row is an alternate row.

Edit Edit Edit Edit 4

行が編集状態であることを示します。通常、行の編集ボタンをクリックするとこの状態になります。Indicates that the row is in an edit state, often the result of clicking an edit button for the row. 通常、Edit 状態と Insert 状態はどちらか一方が適用されます。Typically, the Edit and Insert states are mutually exclusive.

Insert Insert Insert Insert 8

行が新しい行であることを示します。通常、挿入ボタンをクリックして新しい行を追加するとこの状態になります。Indicates that the row is a new row, often the result of clicking an insert button to add a new row. 通常、Insert 状態と Edit 状態はどちらか一方が適用されます。Typically, the Insert and Edit states are mutually exclusive.

Normal Normal Normal Normal 0

データ コントロール行が通常の状態であることを示します。Indicates that the data control row is in a normal state. Normal 状態と、Alternate 状態を除いたその他の状態が同時に適用されることはありません。The Normal state is mutually exclusive with other states except the Alternate state.

Selected Selected Selected Selected 2

行がユーザーに選択されたことを示します。Indicates that the row has been selected by the user.

次のコード例は、使用する方法を示します、DataControlRowState内の行の状態に基づいて、ユーザー インターフェイス (UI) を表示するために列挙をGridViewコントロール。The following code example demonstrates how to use the DataControlRowState enumeration to render a user interface (UI) based on the state of a row in a GridView control. RadioButtonFieldクラスから派生したカスタム フィールドのコントロール、CheckBoxFieldコントロールをすべての行のデータ バインド オプション ボタンを表示、GridViewコントロール。The RadioButtonField class, which is a custom field control that derives from the CheckBoxField control, renders a data-bound radio button for every row in a GridView control. 行をユーザーにデータが表示と編集モードでないときに、RadioButtonコントロールが無効になっています。When the row is displaying data to a user, and is not in edit mode, the RadioButton control is disabled. ユーザーが行を更新するときにGridView、行が編集モードで、RadioButtonクリックするように有効になっているコントロールが表示されます。When the user updates a row in GridView and the row is in edit mode, the RadioButton control is rendered as enabled so that it can be clicked. 例では、行の状態は 1 つまたは複数の組み合わせで可能性があるため、ビットごとの AND 演算子を使用してDataControlRowState値。The example uses bitwise AND operators, because the row state might be a combination of one or more DataControlRowState values. このコード例が示されている例の一部、DataControlFieldクラス。This code example is part of a larger example provided for the DataControlField class.

// 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列挙型などのデータ コントロール内の行の状態の識別DetailsViewまたはGridViewします。The DataControlRowState enumeration identifies the state of a row in a data control such as DetailsView or GridView. 行の状態に設定できるかの組み合わせ、 DataControlRowState 、値は、行の状態が含まれるかどうかを判断するビットごとの演算を使用するため、DataControlRowState等価テストではなく、値します。A row's state can be one or a combination of the DataControlRowState values, so use bitwise operations to determine whether the state of the row includes a DataControlRowState value, rather than an equivalence test. DataControlRowState列挙体は、行の任意の型の使用だけでなくDataRow行 (通常は、行ヘッダーとフッター行の状態から正常に設定されます)。The DataControlRowState enumeration is used for any type of row, not just DataRow rows (typically, the state of header and footer rows is set to Normal).

使用することができます、Normalの状態を識別する列挙体をGridViewRowまたはDetailsViewRowオブジェクトを列挙する場合、GridViewRowCollectionまたはDetailsViewRowCollectionコレクション、それぞれします。You can use the Normal enumeration to identify the state of a GridViewRow or DetailsViewRow object when enumerating through a GridViewRowCollection or DetailsViewRowCollection collection, respectively. 行を使用するデータ コントロールを作成する場合は使用できます、DataControlRowState行 (代替値)、または有効または無効 (編集および挿入値) の行を編集するためにコントロールを別の色を表示するタイミングを識別するために列挙します。If you are writing a data control that uses rows, you can use the DataControlRowState enumeration to identify when to render different colors for a row (the Alternate value), or controls that are enabled or disabled for editing a row (the Edit and Insert values).

適用対象

こちらもご覧ください