SqlDataAdapter.RowUpdating Evento

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Se produce durante el método Update(DataSet), antes de que se ejecute un comando en el origen de datos. Se ha realizado un intento de actualización, de manera que se inicia el evento.

public:
 event Microsoft::Data::SqlClient::SqlRowUpdatingEventHandler ^ RowUpdating;

public event Microsoft.Data.SqlClient.SqlRowUpdatingEventHandler RowUpdating;

member this.RowUpdating : Microsoft.Data.SqlClient.SqlRowUpdatingEventHandler 

Public Custom Event RowUpdating As SqlRowUpdatingEventHandler 

Tipo de evento

SqlRowUpdatingEventHandler

Ejemplos

En el ejemplo siguiente se muestra cómo usar los RowUpdating eventos y RowUpdated .

El RowUpdating evento devuelve esta salida:

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

El RowUpdated evento devuelve esta salida:

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 connectionString =
                  "Integrated Security=SSPI;database=Northwind;server=MSSQL1";
        const string queryString = "SELECT * FROMProducts";

        // create DataAdapter
        SqlDataAdapter adapter = new SqlDataAdapter(queryString, connectionString);
        SqlCommandBuilder builder = new SqlCommandBuilder(adapter);

        // Create and fill DataSet (select only first 5 rows)
        DataSet dataSet = new DataSet();
        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 + ")");
    }
}

Comentarios

Al usar Update, hay dos eventos que se producen por fila de datos actualizada. El orden de ejecución es el siguiente:

1. Los valores de DataRow se mueven a los valores de parámetro.

2. Se genera el evento OnRowUpdating.

3. El comando se ejecuta.

4. Si el comando se establece FirstReturnedRecorden , el primer resultado devuelto se coloca en .DataRow

5. Si hay parámetros de salida, se colocan en .DataRow

6. Se genera el evento OnRowUpdated.

7. Se llama a AcceptChanges.