DataControlRowState Enumeration

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt den Zustand einer Zeile in einem Datensteuerelement an, z. B. als DetailsView oder GridView.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class DataControlRowState

[System.Flags]
public enum DataControlRowState

[<System.Flags>]
type DataControlRowState =

Public Enum DataControlRowState

Vererbung: Object

ValueType

Enum
DataControlRowState

Attribute: FlagsAttribute

Felder

Alternate	1	Gibt an, dass die Zeile des Datensteuerelements eine alternative Zeile ist. Die Zustand `Alternate` kann jederzeit mit anderen Zuständen kombiniert werden, z.B. `Normal`, `Edit` oder `Insert`. Diese Zeilen werden möglicherweise von der `AlternateRowStyle`-Eigenschaft des Datensteuerelements beeinflusst, falls dieses festgelegt ist.
Edit	4	Gibt an, dass sich die Zeile im Bearbeitungszustand befindet. Dieser Zustand wird häufig durch Klicken auf eine Bearbeitungsschaltfläche für die Zeile bewirkt. In der Regel schließen der Edit-Zustand und der Insert-Zustand einander aus.
Insert	8	Gibt an, dass es sich um eine neue Zeile handelt. Häufig wird durch Klicken auf eine Einfügeschaltfläche eine neue Zeile hinzugefügt. In der Regel schließen der Insert-Zustand und der Edit-Zustand einander aus.
Normal	0	Gibt an, dass sich die Zeile des Datensteuerelements in einem normalen Zustand befindet. Der Normal-Zustand schließt sich mit anderen Zuständen außer dem Alternate-Zustand gegenseitig aus.
Selected	2	Gibt an, dass die Zeile vom Benutzer ausgewählt wurde.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die DataControlRowState Enumeration verwendet wird, um eine Benutzeroberfläche basierend auf dem Zustand einer Zeile in einem GridView Steuerelement zu rendern. Die RadioButtonField -Klasse, bei der es sich um ein benutzerdefiniertes Feldsteuerelement handelt, das CheckBoxField vom Steuerelement abgeleitet wird, rendert ein datengebundenes Optionsfeld für jede Zeile in einem GridView Steuerelement. Wenn die Zeile Daten für einen Benutzer anzeigt und sich nicht im Bearbeitungsmodus befindet, wird das RadioButton Steuerelement deaktiviert. Wenn der Benutzer eine Zeile in GridView aktualisiert und sich die Zeile im Bearbeitungsmodus befindet, wird das RadioButton Steuerelement als aktiviert gerendert, sodass darauf geklickt werden kann. Im Beispiel werden bitweise AND-Operatoren verwendet, da der Zeilenzustand eine Kombination aus mindestens einem DataControlRowState Wert sein kann. Dieses Beispiel ist Teil eines größeren Beispiels, das für die DataControlField -Klasse bereitgestellt wird.

// 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

Hinweise

Die DataControlRowState Enumeration identifiziert den Zustand einer Zeile in einem Datensteuerelement wie DetailsView oder GridView. Der Zustand einer Zeile kann ein oder eine Kombination der DataControlRowState Werte sein. Verwenden Sie daher bitweise Vorgänge, um zu bestimmen, ob der Zustand der Zeile einen DataControlRowState Wert anstelle eines Äquivalenztests enthält. Die DataControlRowState Enumeration wird für jeden Zeilentyp verwendet, nicht nur DataRow für Zeilen (in der Regel ist der Zustand der Kopf- und Fußzeilenzeilen auf Normalfestgelegt).

Können Sie die DataControlRowState Enumeration zum Identifizieren des Status der eine GridViewRow oder DetailsViewRow -Objekts beim Durchlaufen einer GridViewRowCollection oder DetailsViewRowCollection Auflistung bzw. Wenn Sie ein Datensteuerelement schreiben, das Zeilen verwendet, können Sie die DataControlRowState Enumeration verwenden, um zu ermitteln, wann unterschiedliche Farben für eine Zeile (der Alternate Wert) gerendert werden sollen oder welche Steuerelemente zum Bearbeiten einer Zeile (die Edit Werte und Insert ) aktiviert oder deaktiviert sind.

Gilt für:

Teilen über