ListViewInsertedEventArgs.AffectedRows Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.