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.

Alternate の状態は、いつでも NormalEditInsert などの他の状態と組み合わせることができます。The Alternate state can be combined with other states, such as Normal, Edit, or Insert, at any time. データ コントロールの AlternateRowStyle プロパティが設定されている場合、これらの行が影響を受ける可能性があります。These rows might be affected by the AlternateRowStyle property of the data control, if set.

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列挙体を使用して、 GridViewコントロールの行の状態に基づいてユーザーインターフェイス (UI) を表示する方法を示しています。The following 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. コントロールから派生したカスタムフィールドコントロールであるGridView クラスは、コントロールのすべての行に対してデータバインドオプションボタンを表示します。RadioButtonField CheckBoxFieldThe 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つDataControlRowState以上の値の組み合わせである可能性があるため、ビットごとの and 演算子を使用します。The example uses bitwise AND operators, because the row state might be a combination of one or more DataControlRowState values. この例は、 DataControlFieldクラスに対して提供される大規模な例の一部です。This 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体は、 DetailsViewGridViewなどのデータコントロールの行の状態を識別します。The DataControlRowState enumeration identifies the state of a row in a data control such as DetailsView or GridView. 行の状態は、1つまたは複数の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. 列挙体は、行だけDataRowではなく、任意の種類の行に使用されます (通常は、ヘッダー行Normalとフッター行の状態がに設定されます)。 DataControlRowStateThe 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).

DataControlRowState列挙体を使用すると、コレクションGridViewRowCollectionまたはDetailsViewRowCollectionコレクションGridViewRowDetailsViewRow列挙するときに、オブジェクトまたはオブジェクトの状態をそれぞれ識別できます。You can use the DataControlRowState enumeration to identify the state of a GridViewRow or DetailsViewRow object when enumerating through a GridViewRowCollection or DetailsViewRowCollection collection, respectively. 行を使用するデータコントロールを作成する場合は、 DataControlRowState列挙体を使用して、行のさまざまな色を表示するタイミングAlternate (値)、または行をEdit編集するために有効または無効にするコントロール (とInsert)を識別できます。値)。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).

適用対象

こちらもご覧ください