SqlRowUpdatedEventArgs Classe

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Fournit des données pour l'événement RowUpdated.

public ref class SqlRowUpdatedEventArgs sealed : System::Data::Common::RowUpdatedEventArgs

public sealed class SqlRowUpdatedEventArgs : System.Data.Common.RowUpdatedEventArgs

type SqlRowUpdatedEventArgs = class
    inherit RowUpdatedEventArgs

Public NotInheritable Class SqlRowUpdatedEventArgs
Inherits RowUpdatedEventArgs

Héritage

RowUpdatedEventArgs

SqlRowUpdatedEventArgs

Exemples

L’exemple suivant montre comment utiliser les RowUpdating événements et .RowUpdated

L’événement RowUpdating retourne cette sortie :

Arguments d’événement : (command=Microsoft.Data.SqlClient.SqlCommand commandType=2 status=0)

L’événement RowUpdated retourne cette sortie :

Arguments d’événement : (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 + ")");
    }
}

Remarques

L’événement RowUpdated est déclenché lorsqu’un Update à une ligne est terminé.

Lors de l’utilisation de Update, deux événements se produisent pour chaque ligne de données mise à jour. L’ordre d’exécution est le suivant :

1. Les valeurs dans le DataRow sont déplacées vers les valeurs de paramètre.

2. L'événement OnRowUpdating est déclenché.

3. La commande s’exécute.

4. Si la commande a la FirstReturnedRecordvaleur , et que le premier résultat retourné est placé dans .DataRow

5. S’il existe des paramètres de sortie, ils sont placés dans .DataRow

6. L'événement OnRowUpdated est déclenché.

7. AcceptChanges est appelée.

Constructeurs

SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

Initialise une nouvelle instance de la classe SqlRowUpdatedEventArgs.

Propriétés

Command

Obtient ou définit SqlCommand qui est exécuté lorsque Update(DataSet) est appelé.