SqlRowUpdatedEventArgs Osztály

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Adatokat biztosít az RowUpdated eseményhez.

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

Öröklődés

Object

EventArgs

RowUpdatedEventArgs

SqlRowUpdatedEventArgs

Példák

Az alábbi példa bemutatja, hogyan használhatja mind az eseményeket, mind az RowUpdatingRowUpdated eseményeket.

Az RowUpdating esemény a következő kimenetet adja vissza:

Eseményargumentumok: (command=System.Data.SqlClient.SqlCommand commandType=2 status=0)

Az RowUpdated esemény a következő kimenetet adja vissza:

Eseményargumentumok: (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

Megjegyzések

Az RowUpdated esemény akkor jön létre, amikor egy Update sorra befejeződik.

A használat során Updateminden frissített adatsorhoz két esemény tartozik. A végrehajtás sorrendje a következő:

1. A rendszer a DataRow benne lévő értékeket a paraméterértékekbe helyezi át.

2. A OnRowUpdating esemény aktiválódik.

3. A parancs végrehajtja a parancsot.

4. Ha a parancs be van állítva FirstReturnedRecord, és az első visszaadott eredmény a következőre DataRowvan állítva: .

5. Ha vannak kimeneti paraméterek, azok a DataRow.

6. A OnRowUpdated esemény aktiválódik.

7. Így nevezik: AcceptChanges.

Konstruktorok

Name	Description
SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializálja a SqlRowUpdatedEventArgs osztály új példányát.

Tulajdonságok

Name	Description
Command	Lekéri vagy beállítja a SqlCommand végrehajtást, amikor Update(DataSet) meghívják.
Errors	A .NET adatszolgáltató által a Command végrehajtásakor keletkező hibákat kapja. (Öröklődés forrása RowUpdatedEventArgs)
RecordsAffected	Lekéri az SQL-utasítás végrehajtásával módosított, beszúrt vagy törölt sorok számát. (Öröklődés forrása RowUpdatedEventArgs)
Row	Lekéri az DataRow elküldött egy Update(DataSet). (Öröklődés forrása RowUpdatedEventArgs)
RowCount	Lekéri a frissített rekordok kötegében feldolgozott sorok számát. (Öröklődés forrása RowUpdatedEventArgs)
StatementType	Lekéri a végrehajtott SQL-utasítás típusát. (Öröklődés forrása RowUpdatedEventArgs)
Status	Lekéri a UpdateStatus tulajdonságot Command . (Öröklődés forrása RowUpdatedEventArgs)
TableMapping	Lekéri az DataTableMapping elküldött egy Update(DataSet). (Öröklődés forrása RowUpdatedEventArgs)

Metódusok

Name	Description
CopyToRows(DataRow[], Int32)	A módosított sorokra mutató hivatkozásokat másolja a megadott tömbbe. (Öröklődés forrása RowUpdatedEventArgs)
CopyToRows(DataRow[])	A módosított sorokra mutató hivatkozásokat másolja a megadott tömbbe. (Öröklődés forrása RowUpdatedEventArgs)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• ADO.NET áttekintése