SqlRowUpdatingEventArgs Osztály

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Adatokat biztosít az RowUpdating eseményhez.

public ref class SqlRowUpdatingEventArgs sealed : System::Data::Common::RowUpdatingEventArgs

public sealed class SqlRowUpdatingEventArgs : System.Data.Common.RowUpdatingEventArgs

type SqlRowUpdatingEventArgs = class
    inherit RowUpdatingEventArgs

Public NotInheritable Class SqlRowUpdatingEventArgs
Inherits RowUpdatingEventArgs

Öröklődés

Object

EventArgs

RowUpdatingEventArgs

SqlRowUpdatingEventArgs

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:

event args: (command=System.Data.SqlClient.SQLCommand commandType=2 status=0)

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

event args: (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 CONNECTION_STRING = "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer";
    const string SELECT_ALL = "select * from Products";

    //Create DataAdapter.
    SqlDataAdapter rAdapter    = new SqlDataAdapter(SELECT_ALL, CONNECTION_STRING);

    //Create and fill DataSet (Select only first 5 rows.).
    DataSet rDataSet = new DataSet();
    rAdapter.Fill(rDataSet, 0, 5, "Table");

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

    //Add handlers.
    rAdapter.RowUpdating += new SqlRowUpdatingEventHandler( OnRowUpdating );
    rAdapter.RowUpdated += new SqlRowUpdatedEventHandler( OnRowUpdated );

    //Update--this operation fires two events (RowUpdating and RowUpdated) for each changed row.
    rAdapter.Update(rDataSet, "Table");

    //Remove handlers.
    rAdapter.RowUpdating -= new SqlRowUpdatingEventHandler( OnRowUpdating );
    rAdapter.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 

'Entry point which delegates to C-style main Private Function.
Public Overloads Shared Sub Main()
    System.Environment.ExitCode = Main(System.Environment.GetCommandLineArgs())
End Sub

Overloads Public Shared Function Main(args() As String) As Integer
    Const CONNECTION_STRING As String = "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer"
    Const SELECT_ALL As String = "select * from Products"
    
    'Create DataAdapter.
    Dim rAdapter As New SqlDataAdapter(SELECT_ALL, CONNECTION_STRING)
    
    'Create and fill DataSet (Select only first 5 rows.).
    Dim rDataSet As New DataSet()
    rAdapter.Fill(rDataSet, 0, 5, "Table")
    
    'Modify DataSet.
    Dim rTable As DataTable = rDataSet.Tables("Table")
    rTable.Rows(0)(1) = "new product"
    
    'Add handlers.
    AddHandler rAdapter.RowUpdating, AddressOf OnRowUpdating
    AddHandler rAdapter.RowUpdated, AddressOf OnRowUpdated
    
    'Update--this operation fires two events (RowUpdating and RowUpdated) for each changed row. 
    rAdapter.Update(rDataSet, "Table")
    
    'Remove handlers.
    RemoveHandler rAdapter.RowUpdating, AddressOf OnRowUpdating
    RemoveHandler rAdapter.RowUpdated, AddressOf OnRowUpdated
    Return 0
End Function 

Overloads Private 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 


Overloads Private 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

Megjegyzések

Az RowUpdating esemény egy sor elé Update kerül.

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
SqlRowUpdatingEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializálja a SqlRowUpdatingEventArgs osztály új példányát.

Tulajdonságok

Name	Description
BaseCommand	Lekéri vagy beállítja az IDbCommand objektumot az osztály egy példányához. (Öröklődés forrása RowUpdatingEventArgs)
Command	Lekéri vagy beállítja a SqlCommand végrehajtáshoz a Update(DataSet).
Errors	A .NET adatszolgáltató által a Command végrehajtásakor keletkező hibákat kapja. (Öröklődés forrása RowUpdatingEventArgs)
Row	Lekéri a DataRow kiszolgálóra a beszúrási, frissítési vagy törlési művelet részeként küldendő műveletet. (Öröklődés forrása RowUpdatingEventArgs)
StatementType	Lekéri a végrehajtandó SQL-utasítás típusát. (Öröklődés forrása RowUpdatingEventArgs)
Status	Lekéri vagy beállítja a UpdateStatus tulajdonságot Command . (Öröklődés forrása RowUpdatingEventArgs)
TableMapping	Lekéri a DataTableMapping küldést a Update(DataSet). (Öröklődés forrása RowUpdatingEventArgs)

Metódusok

Name	Description
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