Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataControlRowState énumération

 

Date de publication : novembre 2016

Spécifie l’état d’une ligne dans un contrôle de données, tel que DetailsView ou GridView.

Cette énumération possède un attribut FlagsAttribute qui permet une combinaison d’opérations de bits de ses valeurs membres.

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

[FlagsAttribute]
public enum DataControlRowState

Nom du membreDescription
Alternate

Indique que la ligne de contrôle de données est une ligne en alternance.

Edit

Indique que la ligne est dans un état de modification, souvent le résultat d’un clic sur un bouton Modifier pour la ligne. En règle générale, les Edit et Insert les États s’excluent mutuellement.

Insert

Indique que la ligne est une nouvelle ligne, souvent le résultat d’un clic sur un bouton Insérer pour ajouter une nouvelle ligne. En règle générale, les Insert et Edit les États s’excluent mutuellement.

Normal

Indique que la ligne de contrôle de données est dans un état normal. La Normal état s’excluent mutuellement avec d’autres États, sauf le Alternate état.

Selected

Indique que la ligne a été sélectionnée par l’utilisateur.

Le DataControlRowState énumération identifie l’état d’une ligne dans un contrôle de données tel que DetailsView ou GridView. État d’une ligne peut être une ou une combinaison de la DataControlRowState valeurs, utilisez donc les opérations au niveau du bit pour déterminer si l’état de la ligne inclut un DataControlRowState valeur, au lieu d’un test d’équivalence. Le DataControlRowState énumération est utilisée pour tout type de ligne, pas seulement DataRow lignes (en général, l’état des lignes d’en-tête et pied de page est défini sur Normal).

Vous pouvez utiliser la DataControlRowState énumération pour identifier l’état d’un GridViewRow ou DetailsViewRow lors de l’énumération par le biais de l’objet une GridViewRowCollection ou DetailsViewRowCollection collection, respectivement. Si vous écrivez un contrôle de données qui utilise des lignes, vous pouvez utiliser la DataControlRowState énumération pour identifier quand restituer différentes couleurs pour une ligne (la Alternate valeur), ou des contrôles qui sont activés ou désactivés pour la modification d’une ligne (la Edit et Insert valeurs).

L’exemple de code suivant montre comment utiliser le DataControlRowState énumération pour restituer une interface utilisateur (IU) basée sur l’état d’une ligne dans un GridView contrôle. Le RadioButtonField (classe), qui est un contrôle de champ personnalisé qui dérive de la CheckBoxField contrôler, restitue une case d’option lié aux données pour chaque ligne dans un GridView contrôle. Lorsque la ligne affiche des données à un utilisateur et n’est pas en mode édition, le RadioButton est désactivé. Lorsque l’utilisateur met à jour une ligne dans GridView et la ligne est en mode édition, la RadioButton contrôle est restitué comme actif afin qu’il peut être sélectionné. L’exemple utilise des opérateurs au niveau du bit, car l’état de ligne peut être une combinaison d’une ou plusieurs DataControlRowState valeurs. Cet exemple de code fait partie d’un exemple plus complet fourni pour la DataControlField classe.

// 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);
}

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: