SqlRowUpdatedEventArgs Klasse

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

RowUpdatedEventArgs

SqlRowUpdatedEventArgs

Beispiele

Im folgenden Beispiel wird gezeigt, wie sowohl das -RowUpdatedEreignis als auch das RowUpdating -Ereignis verwendet werden.

Das RowUpdating Ereignis gibt diese Ausgabe zurück:

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

Das RowUpdated Ereignis gibt diese Ausgabe zurück:

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

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    private DataSet DataSet1;
    private DataGrid dataGrid1;

    // 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 =
                  "Integrated Security=SSPI;database=Northwind;server=MSSQL1";
        const string queryString = "SELECT * FROMProducts";

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

        // Create and fill DataSet (select only first 5 rows)
        DataSet dataSet = new DataSet();
        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 + ")");
    }
}

Hinweise

Das RowUpdated -Ereignis wird ausgelöst, wenn eine Update zu einer Zeile abgeschlossen wird.

Bei Verwendung von Updatetreten für jede aktualisierte Datenzeile zwei Ereignisse auf. Die Ausführungsreihenfolge lautet wie folgt:

1. Die Werte in werden DataRow in die Parameterwerte verschoben.

2. Das OnRowUpdating-Ereignis wird ausgelöst.

3. Der Befehl wird ausgeführt.

4. Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, und das erste zurückgegebene Ergebnis in der DataRowplatziert wird.

5. Wenn Ausgabeparameter vorhanden sind, werden sie im DataRowplatziert.

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. AcceptChanges wird aufgerufen.

Konstruktoren

SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

Initialisiert eine neue Instanz der SqlRowUpdatedEventArgs-Klasse.

Eigenschaften

Command

Ruft den beim Aufruf von SqlCommand ausgeführten Update(DataSet) ab oder legt diesen fest.