DataControlRowState Výčet

Definice

Určuje stav řádku v ovládacím prvku dat, například DetailsView nebo GridView .Specifies the state of a row in a data control, such as DetailsView or GridView.

Tento výčet má atribut FlagsAttribute, který umožňuje bitové kombinace hodnot členů.

public enum class DataControlRowState
[System.Flags]
public enum DataControlRowState
[<System.Flags>]
type DataControlRowState = 
Public Enum DataControlRowState
Dědičnost
DataControlRowState
Atributy

Pole

Alternate 1

Indikuje, že řádek řízení dat je alternativním řádkem.Indicates that the data control row is an alternate row.

AlternateStav lze v kombinaci s jinými stavy, například Normal , Edit nebo Insert , kdykoli.The Alternate state can be combined with other states, such as Normal, Edit, or Insert, at any time. Tyto řádky mohou být ovlivněny AlternateRowStyle vlastností ovládacího prvku dat, pokud je nastavena.These rows might be affected by the AlternateRowStyle property of the data control, if set.

Edit 4

Označuje, že řádek je ve stavu úprav, často se jedná o výsledek kliknutí na tlačítko pro úpravy řádku.Indicates that the row is in an edit state, often the result of clicking an edit button for the row. EditStavy a se typicky vylučují Insert .Typically, the Edit and Insert states are mutually exclusive.

Insert 8

Označuje, že řádek je nový řádek, často se jedná o výsledek kliknutí na tlačítko Vložit pro přidání nového řádku.Indicates that the row is a new row, often the result of clicking an insert button to add a new row. InsertStavy a se typicky vylučují Edit .Typically, the Insert and Edit states are mutually exclusive.

Normal 0

Označuje, že řádek ovládacího prvku dat je v normálním stavu.Indicates that the data control row is in a normal state. NormalStav se vzájemně vylučuje s ostatními stavy s výjimkou Alternate stavu.The Normal state is mutually exclusive with other states except the Alternate state.

Selected 2

Označuje, že řádek byl vybrán uživatelem.Indicates that the row has been selected by the user.

Příklady

Následující příklad ukazuje, jak použít DataControlRowState výčet k vykreslení uživatelského rozhraní (UI) na základě stavu řádku v GridView ovládacím prvku.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. RadioButtonFieldTřída, která je ovládací prvek vlastního pole, který je odvozen z CheckBoxField ovládacího prvku, vykreslí přepínač vázaný na data pro každý řádek v GridView ovládacím prvku.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. Když řádek zobrazuje data pro uživatele a není v režimu úprav, je RadioButton ovládací prvek zakázán.When the row is displaying data to a user and is not in edit mode, the RadioButton control is disabled. Když uživatel aktualizuje řádek v GridView a řádek je v režimu úprav, RadioButton ovládací prvek se vykreslí jako povolený, aby se mohl kliknout.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. V příkladu se používá bitový operátor AND, protože stav řádku může být kombinace jedné nebo více DataControlRowState hodnot.The example uses bitwise AND operators, because the row state might be a combination of one or more DataControlRowState values. Tento příklad je součástí většího příkladu, který je k dispozici pro DataControlField třídu.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

Poznámky

DataControlRowStateVýčet identifikuje stav řádku v ovládacím prvku dat, například DetailsView nebo GridView .The DataControlRowState enumeration identifies the state of a row in a data control such as DetailsView or GridView. Stav řádku může být jedna nebo kombinace DataControlRowState hodnot, takže pomocí bitových operací určíte, zda stav řádku obsahuje DataControlRowState hodnotu, nikoli test ekvivalence.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. DataControlRowStateVýčet se používá pro libovolný typ řádku, ne jenom DataRow pro řádky (obvykle se jedná o stav řádků záhlaví a zápatí je nastavená na Normal ).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).

Můžete použít DataControlRowState výčet k identifikaci stavu GridViewRow DetailsViewRow objektu nebo při vytváření výčtu GridViewRowCollection kolekce nebo v DetailsViewRowCollection uvedeném pořadí.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. Pokud píšete ovládací prvek dat, který používá řádky, můžete použít DataControlRowState výčet k určení, kdy se mají vykreslovat různé barvy pro řádek ( Alternate hodnota), nebo ovládací prvky, které jsou povoleny nebo zakázány pro úpravu řádku ( Edit Insert hodnoty a).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).

Platí pro

Viz také