ListViewInsertedEventArgs.AffectedRows Eigenschaft
Definition
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.
Ruft die Anzahl der Zeilen ab, die vom Einfügevorgang betroffen sind.
public:
property int AffectedRows { int get(); };public int AffectedRows { get; }member this.AffectedRows : intPublic ReadOnly Property AffectedRows As IntegerEigenschaftswert
Die Anzahl der Zeilen, die von dem Einfügevorgang betroffen sind.
Beispiele
Das folgende Beispiel zeigt, wie Sie das ListViewInsertedEventArgs Objekt verwenden, das an einen Handler für das ItemInserted Ereignis übergeben wird, um zu bestimmen, ob während des Einfügevorgangs eine Ausnahme ausgelöst wurde. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewInsertedEventArgs Klasse bereitgestellt wird.
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
Hinweise
Verwenden Sie die AffectedRows Eigenschaft, um die Anzahl der Datensätze zu bestimmen, die vom Einfügevorgang betroffen waren, wie sie vom Datenquellensteuerelement zurückgegeben wurden. Diese Eigenschaft wird in der Regel in den folgenden Szenarien verwendet:
So überprüfen Sie, ob nur ein einzelner Datensatz eingefügt wurde. Manchmal kann eine falsch geschriebene Insert-Anweisung mehrere Datensätze einfügen.
Um zu überprüfen, ob ein Datensatz nicht eingefügt wurde, weil während des Einfügevorgangs ein Fehler aufgetreten ist, aber keine Ausnahme ausgelöst wurde.
Um zu überprüfen, ob ein Datensatz eingefügt wurde, wenn ein Datenquellensteuerelement, das die Konflikterkennung unterstützt (optimistische Parallelität), auf ConflictDetection den
ConflictOptions.CompareAllValuesEnumerationswert festgelegt ist. Steuerelemente, die diese Eigenschaft unterstützen, umfassen die SqlDataSource Und-Steuerelemente ObjectDataSource . Wenn die Eigenschaft diesen Wert aufweist, wird ein Datensatz möglicherweise nicht eingefügt, wenn er denselben Schlüsselwert wie ein von einem anderen Benutzer eingefügter Datensatz aufweist.
