SqlDataAdapter.RowUpdating 事件

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.SqlClient.dll

套件:

System.Data.SqlClient v4.9.0

來源:

System.Data.SqlClient.notsupported.cs

發生在已經針對資料來源執行命令前的 Update(DataSet) 期間。 嘗試進行更新，因此引發了事件。

public event System.Data.SqlClient.SqlRowUpdatingEventHandler RowUpdating;

事件類型

SqlRowUpdatingEventHandler

範例

下列範例示範如何使用 RowUpdating 和 RowUpdated 事件。

事件會 RowUpdating 傳回此輸出：

事件自變數： (command=System.Data.SqlClient.SqlCommand commandType=2 status=0)

事件會 RowUpdated 傳回此輸出：

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

// 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 * FROM Products";

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

備註

使用 Update時，每個數據列都會更新兩個事件。 執行順序如下：

1. 中的 DataRow 值會移至參數值。

2. 便會引發 OnRowUpdating 事件。

3. 命令會執行。

4. 如果命令設定為 FirstReturnedRecord，則會將 DataRow第一個傳回的結果放在 中。

5. 如果有輸出參數，它們會放在 中 DataRow。

6. 便會引發 OnRowUpdated 事件。

7. 呼叫 AcceptChanges。

適用於

另請參閱

• 操作資料 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 $\mathrm{部}\mathrm{分}\mathrm{機}\mathrm{器}\mathrm{翻}\mathrm{譯}$