Partager via


ListViewInsertedEventArgs.AffectedRows Propriété

Définition

Obtient le nombre de lignes affectées par l'opération d'insertion.

public:
 property int AffectedRows { int get(); };
public int AffectedRows { get; }
member this.AffectedRows : int
Public ReadOnly Property AffectedRows As Integer

Valeur de propriété

Nombre de lignes affectées par l'opération d'insertion.

Exemples

L’exemple suivant montre comment utiliser l’objet ListViewInsertedEventArgs passé à un gestionnaire pour l’événement ItemInserted afin de déterminer si une exception a été levée pendant l’opération d’insertion. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ListViewInsertedEventArgs classe .

void ContactsListView_ItemInserted(Object sender, ListViewInsertedEventArgs e)
{
  if (e.Exception != null)
  {
    if (e.AffectedRows == 0)
    {
      e.KeepInInsertMode = true;
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify your values and try again.";
    }
    else
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify the values in the newly inserted item.";

    e.ExceptionHandled = true;
  }
}
Sub ContactsListView_ItemInserted(ByVal sender As Object, ByVal e As ListViewInsertedEventArgs)

  If e.Exception IsNot Nothing Then

    If e.AffectedRows = 0 Then
      e.KeepInInsertMode = True
      Message.Text = "An exception occurred inserting the new Contact. " & _
        "Please verify your values and try again."
    Else
      Message.Text = "An exception occurred inserting the new Contact. " & _
        "Please verify the values in the newly inserted item."
    End If

    e.ExceptionHandled = True
  End If
End Sub

Remarques

Utilisez la AffectedRows propriété pour déterminer le nombre d’enregistrements qui ont été affectés par l’opération d’insertion, comme retourné par le contrôle de source de données. Cette propriété est généralement utilisée dans les scénarios suivants :

  • Pour vérifier qu’un seul enregistrement a été inséré. Parfois, une instruction d’insertion incorrectement écrite peut insérer plusieurs enregistrements.

  • Pour vérifier qu’un enregistrement n’a pas été inséré, car une erreur s’est produite pendant l’opération d’insertion, mais qu’une exception n’a pas été levée.

  • Pour vérifier qu’un enregistrement a été inséré lorsqu’un contrôle de source de données prenant en charge la détection de conflits (accès concurrentiel optimiste) a sa ConflictDetection propriété définie sur la valeur d’énumération ConflictOptions.CompareAllValues . Les contrôles qui prennent en charge cette propriété incluent les SqlDataSource contrôles et ObjectDataSource . Lorsque la propriété a cette valeur, un enregistrement peut ne pas être inséré s’il a la même valeur de clé qu’un enregistrement inséré par un autre utilisateur.

S’applique à

Voir aussi