ListViewUpdatedEventArgs.AffectedRows Eigenschaft

Definition

Ruft die Anzahl der vom Aktualisierungsvorgang betroffenen Zeilen ab.Gets the number of rows that were affected by the update operation.

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.The number of rows that were affected by the update operation.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die AffectedRows -Eigenschaft verwendet wird, um zu überprüfen, ob ein Element aktualisiert wurde.The following example shows how to use the AffectedRows property to verify that an item was updated. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewUpdatedEventArgs -Klasse bereitgestellt wird.This code example is part of a larger example provided for the ListViewUpdatedEventArgs class.

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 AffectedRows die-Eigenschaft, um die Anzahl der vom Aktualisierungs Vorgang betroffenen Zeilen zu bestimmen, die von der Datenquelle zurückgegeben wurden.Use the AffectedRows property to determine the number of rows that were affected by the update operation, as returned by the data source. Da in der Regel nur ein Element aktualisiert wird, enthält diese Eigenschaft normalerweise den Wert 0 oder 1.Because typically only one item is updated, this property usually contains a value of 0 or 1.

Manchmal kann während des Aktualisierungs Vorgangs ein Fehler auftreten, der keine Ausnahme auslöst.Sometimes during the update operation an error can occur that does not raise an exception. In diesem Fall kann die AffectedRows -Eigenschaft verwendet werden, um zu überprüfen, ob ein Element aktualisiert wurde.In that case, the AffectedRows property can be used to verify that an item was updated.

Gilt für:

Siehe auch