Freigeben über


ListViewInsertedEventArgs.AffectedRows Eigenschaft

Definition

Ruft die Anzahl der vom Einfügevorgang 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 Einfügevorgang betroffenen Zeilen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie das ListViewInsertedEventArgs -Objekt verwendet wird, 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 sind, wie sie vom Datenquellensteuerelement zurückgegeben wird. Diese Eigenschaft wird in der Regel in den folgenden Szenarien verwendet:

  • Um zu überprüfen, 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 die -Eigenschaft eines Datenquellensteuerelements, das die Konflikterkennung unterstützt (optimistische Parallelität) unterstützt, auf den ConflictOptions.CompareAllValues Enumerationswert festgelegt istConflictDetection. Steuerelemente, die diese Eigenschaft unterstützen, umfassen die SqlDataSource Steuerelemente und ObjectDataSource . Wenn die Eigenschaft über diesen Wert verfügt, wird ein Datensatz möglicherweise nicht eingefügt, wenn er denselben Schlüsselwert wie ein von einem anderen Benutzer eingefügter Datensatz aufweist.

Gilt für:

Weitere Informationen