SqlRowUpdatingEventArgs Classe

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Fornece dados para o evento de 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

Herança

RowUpdatingEventArgs

SqlRowUpdatingEventArgs

Exemplos

O exemplo a seguir mostra como usar os RowUpdating eventos e RowUpdated .

O RowUpdating evento retorna esta saída:

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

O RowUpdated evento retorna esta saída:

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 + ")");
    }
}

Comentários

O RowUpdating evento é gerado antes de um Update para uma linha.

Quando você está usando Update, há dois eventos que ocorrem para cada linha de dados atualizada. A ordem de execução é a seguinte:

1. Os valores no DataRow são movidos para os valores de parâmetro.

2. O evento OnRowUpdating será gerado.

3. O comando é executado.

4. Se o comando estiver definido como FirstReturnedRecorde o primeiro resultado retornado for colocado no DataRow.

5. Se houver parâmetros de saída, eles serão colocados no DataRow.

6. O evento OnRowUpdated será gerado.

7. AcceptChanges é chamado.

Construtores

SqlRowUpdatingEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa uma nova instância da classe SqlRowUpdatingEventArgs.

Propriedades

Command

Obtém ou define o SqlCommand a ser executado ao realizar a Update(DataSet).