SqlRowUpdatedEventArgs Klasse

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.dll

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.

Stellt Daten für das RowUpdated Ereignis bereit.

public ref class SqlRowUpdatedEventArgs sealed : System::Data::Common::RowUpdatedEventArgs

public sealed class SqlRowUpdatedEventArgs : System.Data.Common.RowUpdatedEventArgs

type SqlRowUpdatedEventArgs = class
    inherit RowUpdatedEventArgs

Public NotInheritable Class SqlRowUpdatedEventArgs
Inherits RowUpdatedEventArgs

Vererbung: Object

EventArgs

RowUpdatedEventArgs
SqlRowUpdatedEventArgs

Beispiele

Das folgende Beispiel zeigt, wie sowohl die Ereignisse als RowUpdating auch die RowUpdated Ereignisse verwendet werden.

Das RowUpdating Ereignis gibt diese Ausgabe zurück:

Ereignisargumente: (command=System.Data.SqlClient.SqlCommand commandType=2 status=0)

Das RowUpdated Ereignis gibt diese Ausgabe zurück:

Ereignisargumente: (command=System.Data.SqlClient.SqlCommand commandType=2 recordsAffected=1 row=System.Data.DataRow[37] status=0)

// handler for RowUpdating event
private static void OnRowUpdating(object sender, SqlRowUpdatingEventArgs e)
{
    PrintEventArgs(e);
}

// handler for RowUpdated event
private static void OnRowUpdated(object sender, SqlRowUpdatedEventArgs e)
{
    PrintEventArgs(e);
}

public static int Main()
{
    const string connectionString = "...";
    const string queryString = "SELECT * FROM Products";

    // create DataAdapter
    SqlDataAdapter adapter = new(queryString, connectionString);
    SqlCommandBuilder builder = new(adapter);

    // Create and fill DataSet (select only first 5 rows)
    DataSet dataSet = new();
    adapter.Fill(dataSet, 0, 5, "Table");

    // Modify DataSet
    DataTable table = dataSet.Tables["Table"];
    table.Rows[0][1] = "new product";

    // add handlers
    adapter.RowUpdating += new SqlRowUpdatingEventHandler(OnRowUpdating);
    adapter.RowUpdated += new SqlRowUpdatedEventHandler(OnRowUpdated);

    // update, this operation fires two events
    // (RowUpdating/RowUpdated) per changed row
    adapter.Update(dataSet, "Table");

    // remove handlers
    adapter.RowUpdating -= new SqlRowUpdatingEventHandler(OnRowUpdating);
    adapter.RowUpdated -= new SqlRowUpdatedEventHandler(OnRowUpdated);
    return 0;
}

private static void PrintEventArgs(SqlRowUpdatingEventArgs args)
{
    Console.WriteLine("OnRowUpdating");
    Console.WriteLine("  event args: (" +
        " command=" + args.Command +
        " commandType=" + args.StatementType +
        " status=" + args.Status + ")");
}

private static void PrintEventArgs(SqlRowUpdatedEventArgs args)
{
    Console.WriteLine("OnRowUpdated");
    Console.WriteLine("  event args: (" +
        " command=" + args.Command +
        " commandType=" + args.StatementType +
        " recordsAffected=" + args.RecordsAffected +
        " status=" + args.Status + ")");
}

    ' handler for RowUpdating event
    Private Shared Sub OnRowUpdating(sender As Object, e As SqlRowUpdatingEventArgs)
        PrintEventArgs(e)
    End Sub

    ' handler for RowUpdated event
    Private Shared Sub OnRowUpdated(sender As Object, e As SqlRowUpdatedEventArgs)
        PrintEventArgs(e)
    End Sub

    Public Overloads Shared Function Main(args() As String) As Integer
        Const connectionString As String = "..."
        Const queryString As String = "SELECT * FROM Products"

        ' create DataAdapter
        Dim adapter As New SqlDataAdapter(queryString, connectionString)
        Dim builder As New SqlCommandBuilder(adapter)

        ' Create and fill DataSet (select only first 5 rows)
        Dim dataSet As New DataSet()
        adapter.Fill(dataSet, 0, 5, "Table")

        ' Modify DataSet
        Dim table As DataTable = dataSet.Tables("Table")
        table.Rows(0)(1) = "new product"

        ' add handlers
        AddHandler adapter.RowUpdating, AddressOf OnRowUpdating
        AddHandler adapter.RowUpdated, AddressOf OnRowUpdated

        ' update, this operation fires two events
        '(RowUpdating/RowUpdated) per changed row
        adapter.Update(dataSet, "Table")

        ' remove handlers
        RemoveHandler adapter.RowUpdating, AddressOf OnRowUpdating
        RemoveHandler adapter.RowUpdated, AddressOf OnRowUpdated
        Return 0
    End Function


    Private Overloads Shared Sub PrintEventArgs(args As SqlRowUpdatingEventArgs)
        Console.WriteLine("OnRowUpdating")
        Console.WriteLine("  event args: (" & " command=" & args.Command.CommandText &
           " commandType=" & args.StatementType & " status=" & args.Status & ")")
    End Sub


    Private Overloads Shared Sub PrintEventArgs(args As SqlRowUpdatedEventArgs)
        Console.WriteLine("OnRowUpdated")
        Console.WriteLine("  event args: (" & " command=" & args.Command.CommandText &
           " commandType=" & args.StatementType & " recordsAffected=" &
           args.RecordsAffected & " status=" & args.Status & ")")
    End Sub
End Class

Hinweise

Das RowUpdated Ereignis wird ausgelöst, wenn eine Update Zeile abgeschlossen ist.

Bei Verwendung Updategibt es zwei Ereignisse, die für jede Datenzeile aktualisiert werden. Die Reihenfolge der Ausführung lautet wie folgt:

Die Werte in der Datei DataRow werden in die Parameterwerte verschoben.
Das OnRowUpdating-Ereignis wird ausgelöst.
Der Befehl wird ausgeführt.
Wenn der Befehl auf FirstReturnedRecord, und das erste zurückgegebene Ergebnis in der DataRow.
Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRowplatziert.
Das OnRowUpdated-Ereignis wird ausgelöst.
AcceptChanges wird aufgerufen.

Konstruktoren

Name	Beschreibung
SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)	Initialisiert eine neue Instanz der SqlRowUpdatedEventArgs-Klasse.

Eigenschaften

Name	Beschreibung
Command	Dient zum Abrufen oder Festlegen der SqlCommand Ausführung, wenn Update(DataSet) aufgerufen wird.
Errors	Ruft alle Fehler ab, die vom .NET Datenanbieter generiert werden, wenn das Command ausgeführt wurde. (Geerbt von RowUpdatedEventArgs)
RecordsAffected	Ruft die Anzahl der Zeilen geändert, eingefügt oder gelöscht durch Ausführung der SQL-Anweisung ab. (Geerbt von RowUpdatedEventArgs)
Row	Ruft den DataRow gesendeten durch eine Update(DataSet). (Geerbt von RowUpdatedEventArgs)
RowCount	Ruft die Anzahl der Zeilen ab, die in einem Batch aktualisierter Datensätze verarbeitet werden. (Geerbt von RowUpdatedEventArgs)
StatementType	Ruft den Typ der ausgeführten SQL-Anweisung ab. (Geerbt von RowUpdatedEventArgs)
Status	Ruft die UpdateStatus Eigenschaft ab Command . (Geerbt von RowUpdatedEventArgs)
TableMapping	Ruft den DataTableMapping gesendeten durch eine Update(DataSet). (Geerbt von RowUpdatedEventArgs)

Methoden

Name	Beschreibung
CopyToRows(DataRow[], Int32)	Kopiert Verweise auf die geänderten Zeilen in das bereitgestellte Array. (Geerbt von RowUpdatedEventArgs)
CopyToRows(DataRow[])	Kopiert Verweise auf die geänderten Zeilen in das bereitgestellte Array. (Geerbt von RowUpdatedEventArgs)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Weitere Informationen

Übersicht über ADO.NET

Feedback

War diese Seite hilfreich?