DataControlRowState Enumerazione

Definizione

Specifica lo stato di una riga in un controllo dati, ad esempio DetailsView o GridView.Specifies the state of a row in a data control, such as DetailsView or GridView.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei valori del relativo membro.

public enum class DataControlRowState
[System.Flags]
public enum DataControlRowState
type DataControlRowState = 
Public Enum DataControlRowState
Ereditarietà
DataControlRowState
Attributi

Campi

Alternate 1

Indica che la riga del controllo dati è alternativa.Indicates that the data control row is an alternate row.

Lo stato Alternate può essere combinato con altri stati, come Normal, Edit o Insert, in qualsiasi momento.The Alternate state can be combined with other states, such as Normal, Edit, or Insert, at any time. Queste righe possono essere influenzate dalla proprietà AlternateRowStyle del controllo dati, se impostata.These rows might be affected by the AlternateRowStyle property of the data control, if set.

Edit 4

Indica che la riga si trova in uno stato di modifica, spesso come conseguenza della scelta di un pulsante di modifica per la riga.Indicates that the row is in an edit state, often the result of clicking an edit button for the row. In genere gli stati Edit e Insert si escludono reciprocamente.Typically, the Edit and Insert states are mutually exclusive.

Insert 8

Indica che la riga è nuova, spesso come conseguenza della scelta di un pulsante di inserimento per aggiungere una nuova riga.Indicates that the row is a new row, often the result of clicking an insert button to add a new row. In genere gli stati Insert e Edit si escludono reciprocamente.Typically, the Insert and Edit states are mutually exclusive.

Normal 0

Indica che la riga del controllo dati si trova nello stato normale.Indicates that the data control row is in a normal state. La stato Normal e gli altri stati ad eccezione dello stato Alternate si escludono reciprocamente.The Normal state is mutually exclusive with other states except the Alternate state.

Selected 2

Indica che la riga è stata selezionata dall'utente.Indicates that the row has been selected by the user.

Esempi

Nell'esempio seguente viene illustrato come utilizzare l' DataControlRowState enumerazione per eseguire il rendering di un'interfaccia utente (UI) in base allo stato di una GridView riga in un controllo.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. La RadioButtonField classe, che è un controllo campo personalizzato che deriva CheckBoxField dal controllo, esegue il rendering di un pulsante di opzione associato a dati per ogni riga di GridView un controllo.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. Quando la riga Visualizza dati a un utente e non è in modalità di modifica, il RadioButton controllo è disabilitato.When the row is displaying data to a user and is not in edit mode, the RadioButton control is disabled. Quando l'utente aggiorna una riga in GridView e la riga è in modalità di modifica, RadioButton viene eseguito il rendering del controllo come abilitato, in modo che sia possibile fare clic su di essa.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. Nell'esempio vengono utilizzati operatori and bit per bit, perché lo stato della riga potrebbe essere una combinazione DataControlRowState di uno o più valori.The example uses bitwise AND operators, because the row state might be a combination of one or more DataControlRowState values. Questo esempio fa parte di un esempio più ampio fornito per DataControlField la classe.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

Commenti

L' DataControlRowState enumerazione identifica lo stato di una riga in un controllo dati DetailsView , ad esempio GridViewo.The DataControlRowState enumeration identifies the state of a row in a data control such as DetailsView or GridView. Lo stato di una riga può essere una o una combinazione dei DataControlRowState valori, quindi utilizzare operazioni bit per bit per determinare se lo stato della riga include DataControlRowState un valore, anziché un test di equivalenza.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. L' DataControlRowState enumerazione viene utilizzata per qualsiasi tipo di riga, non solo DataRow per le righe, in genere lo stato delle righe dell'intestazione e del piè Normaldi pagina è impostato su.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).

È possibile utilizzare l' DataControlRowState enumerazione per identificare lo stato di un GridViewRow oggetto DetailsViewRow o quando si esegue l'enumerazione GridViewRowCollection rispettivamente DetailsViewRowCollection tramite una raccolta o.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. Se si sta scrivendo un controllo dati che utilizza righe, è possibile utilizzare l' DataControlRowState enumerazione per identificare quando eseguire il rendering di colori diversi per una riga Alternate (valore) o i controlli abilitati o disabilitati per la Edit modifica di una riga (e Insertvalori).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).

Si applica a

Vedi anche