SqlRowUpdatedEventArgs 类

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

为 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

继承

RowUpdatedEventArgs

SqlRowUpdatedEventArgs

示例

以下示例演示如何同时使用 RowUpdating 和 RowUpdated 事件。

事件 RowUpdating 返回以下输出：

事件参数： (command=Microsoft.Data.SqlClient.SqlCommand commandType=2 status=0)

事件 RowUpdated 返回以下输出：

事件参数： (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 + ")");
    }
}

注解

完成 RowUpdated 对行的 时 Update 引发 事件。

使用 Update时，更新的每个数据行都会发生两个事件。 执行顺序如下：

1. 中的 DataRow 值将移动到参数值。

2. 引发 OnRowUpdating 事件。

3. 命令将执行。

4. 如果命令设置为 FirstReturnedRecord，并且第一个返回的结果将放置在 中 DataRow。

5. 如果有输出参数，则它们放置在 中 DataRow。

6. 引发 OnRowUpdated 事件。

7. 调用 AcceptChanges。

构造函数

SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

初始化 SqlRowUpdatedEventArgs 类的新实例。

属性

Command

获取或设置当调用 SqlCommand 时执行的 Update(DataSet)。