SqlDataAdapter.RowUpdated 事件

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v7.0.1

發生在 Update(DataSet) 對資料來源執行指令後。 嘗試更新時，事件就會觸發。

public:
 event Microsoft::Data::SqlClient::SqlRowUpdatedEventHandler ^ RowUpdated;

public event Microsoft.Data.SqlClient.SqlRowUpdatedEventHandler RowUpdated;

member this.RowUpdated : Microsoft.Data.SqlClient.SqlRowUpdatedEventHandler 

Public Custom Event RowUpdated As SqlRowUpdatedEventHandler 

事件類型

SqlRowUpdatedEventHandler

範例

以下範例說明如何使用 和 RowUpdatingRowUpdated 事件。

using System;
using System.Data;
using System.Data.Common;
using System.Windows.Forms;
using System.Xml;
using Microsoft.Data.SqlClient;

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

該事件回 RowUpdating 傳以下輸出：

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

該事件回 RowUpdated 傳以下輸出：

event args: (command=Microsoft.Data.SqlClient.SqlCommand commandType=2 recordsAffected=1 row=System.Data.DataRow[37] status=0)

備註

使用 Update(DataSet)時，每更新一列資料列會發生兩個事件。 執行順序如下：

1. 中的值 DataRow 會被移到參數值。
2. 便會引發 RowUpdating 事件。
3. 指令執行。
4. 如果命令設定為 FirstReturnedRecord，則會將第一個傳回的結果放在 DataRow中。
5. 如果有輸出參數，它們會放在 DataRow中。
6. 便會引發 RowUpdated 事件。
7. 呼叫 AcceptChanges()。