SqlRowUpdatingEventArgs Kelas

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Menyediakan data untuk peristiwa tersebut RowUpdating .

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

Warisan

Object

EventArgs

RowUpdatingEventArgs

SqlRowUpdatingEventArgs

Contoh

Contoh berikut menunjukkan cara menggunakan RowUpdating peristiwa dan RowUpdated .

Kejadian RowUpdating mengembalikan output ini:

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

Kejadian RowUpdated mengembalikan output ini:

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

Keterangan

Peristiwa RowUpdating dinaikkan sebelum menjadi Update satu baris.

Saat Anda menggunakan Update, ada dua peristiwa yang terjadi untuk setiap baris data yang diperbarui. Urutan eksekusi adalah sebagai berikut:

1. Nilai dalam DataRow dipindahkan ke nilai parameter.

2. Peristiwa OnRowUpdating diaktifkan.

3. Perintah dijalankan.

4. Jika perintah diatur ke FirstReturnedRecord, dan hasil pertama yang dikembalikan ditempatkan di DataRow.

5. Jika ada parameter output, parameter tersebut ditempatkan di DataRow.

6. Peristiwa OnRowUpdated diaktifkan.

7. AcceptChanges dipanggil.

Konstruktor

Nama	Deskripsi
SqlRowUpdatingEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)	Menginisialisasi instans baru dari kelas SqlRowUpdatingEventArgs.

Properti

Nama	Deskripsi
BaseCommand	Mendapatkan atau mengatur objek untuk instans IDbCommand kelas ini. (Diperoleh dari RowUpdatingEventArgs)
Command	Mendapatkan atau mengatur SqlCommand untuk dijalankan saat melakukan Update(DataSet).
Errors	Mendapatkan kesalahan apa pun yang dihasilkan oleh penyedia data .NET saat Command dijalankan. (Diperoleh dari RowUpdatingEventArgs)
Row	DataRow Mendapatkan yang akan dikirim ke server sebagai bagian dari operasi sisipkan, perbarui, atau hapus. (Diperoleh dari RowUpdatingEventArgs)
StatementType	Mendapatkan jenis pernyataan SQL untuk dijalankan. (Diperoleh dari RowUpdatingEventArgs)
Status	Mendapatkan atau mengatur UpdateStatusCommand properti . (Diperoleh dari RowUpdatingEventArgs)
TableMapping	DataTableMapping Mendapatkan untuk mengirim melalui Update(DataSet). (Diperoleh dari RowUpdatingEventArgs)

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Gambaran Umum ADO.NET