SqlRowUpdatingEventArgs Klasa

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Udostępnia dane dla zdarzenia 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

Dziedziczenie

RowUpdatingEventArgs

SqlRowUpdatingEventArgs

Przykłady

W poniższym przykładzie pokazano, jak używać zarówno zdarzeń, jak RowUpdating i RowUpdated .

Zdarzenie RowUpdating zwraca następujące dane wyjściowe:

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

Zdarzenie RowUpdated zwraca następujące dane wyjściowe:

event args: (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 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 + ")");
    }
}

Uwagi

Zdarzenie RowUpdating jest wywoływane przed Update wierszem.

W przypadku korzystania z programu Updateistnieją dwa zdarzenia, które występują dla każdego zaktualizowanego wiersza danych. Kolejność wykonywania jest następująca:

1. Wartości w elemecie DataRow są przenoszone do wartości parametrów.

2. Zdarzenie OnRowUpdating jest zgłaszane.

3. Polecenie jest wykonywane.

4. Jeśli polecenie ma wartość FirstReturnedRecord, a pierwszy zwrócony wynik zostanie umieszczony w elemecie DataRow.

5. Jeśli istnieją parametry wyjściowe, są one umieszczane w elemecie DataRow.

6. Zdarzenie OnRowUpdated jest zgłaszane.

7. Wywołano metodę AcceptChanges.

Konstruktory

SqlRowUpdatingEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicjuje nowe wystąpienie klasy SqlRowUpdatingEventArgs.

Właściwości

Command

Pobiera lub ustawia element SqlCommand do wykonania podczas wykonywania polecenia Update(DataSet).