ListViewUpdatedEventArgs.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 vom Aktualisierungsvorgang betroffenen Zeilen ab.
public:
property int AffectedRows { int get(); };
public int AffectedRows { get; }
member this.AffectedRows : int
Public ReadOnly Property AffectedRows As Integer
Eigenschaftswert
Die Anzahl der vom Aktualisierungsvorgang betroffenen Zeilen.
Beispiele
Im folgenden Beispiel wird gezeigt, wie die AffectedRows -Eigenschaft verwendet wird, um zu überprüfen, ob ein Element aktualisiert wurde. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewUpdatedEventArgs-Klasse bereitgestellt wird.
void ContactsListView_ItemUpdated(Object sender, ListViewUpdatedEventArgs e)
{
if (e.Exception != null)
{
if (e.AffectedRows == 0)
{
e.KeepInEditMode = true;
Message.Text = "An exception occurred updating the contact. " +
"Please verify your values and try again.";
}
else
Message.Text = "An exception occurred updating the contact. " +
"Please verify the values in the recently updated item.";
e.ExceptionHandled = true;
}
}
Sub ContactsListView_ItemUpdated(sender As Object, e As ListViewUpdatedEventArgs)
If e.Exception IsNot Nothing Then
If e.AffectedRows = 0 Then
e.KeepInEditMode = True
Message.Text = "An exception occurred updating the contact. " & _
"Please verify your values and try again."
Else
Message.Text = "An exception occurred updating the contact. " & _
"Please verify the values in the recently updated item."
End If
e.ExceptionHandled = True
End If
End Sub
Hinweise
Verwenden Sie die AffectedRows -Eigenschaft, um die Anzahl der Zeilen zu bestimmen, die vom Updatevorgang betroffen sind, wie von der Datenquelle zurückgegeben. Da in der Regel nur ein Element aktualisiert wird, enthält diese Eigenschaft in der Regel den Wert 0 oder 1.
Manchmal kann während des Aktualisierungsvorgangs ein Fehler auftreten, der keine Ausnahme auslöst. In diesem Fall kann die AffectedRows -Eigenschaft verwendet werden, um zu überprüfen, ob ein Element aktualisiert wurde.