SqlRowUpdatedEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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
- 継承
例
次の例では、 イベントと RowUpdated イベントの両方を使用する方法をRowUpdating示します。
イベントは、 RowUpdating 次の出力を返します。
イベント引数: (command=System.Data.SqlClient.SqlCommand commandType=2 status=0)
イベントは、 RowUpdated 次の出力を返します。
イベント引数: (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 + ")");
}
' handler for RowUpdating event
Private Shared Sub OnRowUpdating(sender As Object, e As SqlRowUpdatingEventArgs)
PrintEventArgs(e)
End Sub
' handler for RowUpdated event
Private Shared Sub OnRowUpdated(sender As Object, e As SqlRowUpdatedEventArgs)
PrintEventArgs(e)
End Sub
'Entry point which delegates to C-style main Private Function
Public Overloads Shared Sub Main()
System.Environment.ExitCode = Main(System.Environment.GetCommandLineArgs())
End Sub
Overloads Public Shared Function Main(args() As String) As Integer
Const connectionString As String = _
"Integrated Security=SSPI;database=Northwind;server=MSSQL1"
Const queryString As String = "SELECT * FROM Products"
' create DataAdapter
Dim adapter As New SqlDataAdapter(queryString, connectionString)
Dim builder As New SqlCommandBuilder(adapter)
' Create and fill DataSet (select only first 5 rows)
Dim dataSet As New DataSet()
adapter.Fill(dataSet, 0, 5, "Table")
' Modify DataSet
Dim table As DataTable = dataSet.Tables("Table")
table.Rows(0)(1) = "new product"
' add handlers
AddHandler adapter.RowUpdating, AddressOf OnRowUpdating
AddHandler adapter.RowUpdated, AddressOf OnRowUpdated
' update, this operation fires two events
'(RowUpdating/RowUpdated) per changed row
adapter.Update(dataSet, "Table")
' remove handlers
RemoveHandler adapter.RowUpdating, AddressOf OnRowUpdating
RemoveHandler adapter.RowUpdated, AddressOf OnRowUpdated
Return 0
End Function
Overloads Private Shared Sub PrintEventArgs(args As SqlRowUpdatingEventArgs)
Console.WriteLine("OnRowUpdating")
Console.WriteLine(" event args: (" & " command=" & args.Command.CommandText & _
" commandType=" & args.StatementType & " status=" & args.Status & ")")
End Sub
Overloads Private Shared Sub PrintEventArgs(args As SqlRowUpdatedEventArgs)
Console.WriteLine("OnRowUpdated")
Console.WriteLine(" event args: (" & " command=" & args.Command.CommandText & _
" commandType=" & args.StatementType & " recordsAffected=" & _
args.RecordsAffected & " status=" & args.Status & ")")
End Sub
End Class
注釈
行 RowUpdated への が Update 完了すると、イベントが発生します。
を使用 Updateする場合、更新されたデータ行ごとに 2 つのイベントが発生します。 実行順序は次のとおりです。
内の DataRow 値はパラメーター値に移動されます。
OnRowUpdating イベントが発生します。
コマンドが実行されます。
コマンドが に設定され、最初に
FirstReturnedRecord
返された結果が に DataRow配置される場合。出力パラメーターがある場合は、 に配置されます DataRow。
OnRowUpdated イベントが発生します。
AcceptChanges が呼ばれたとき。
コンストラクター
SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping) |
SqlRowUpdatedEventArgs クラスの新しいインスタンスを初期化します。 |
プロパティ
Command |
SqlCommand の呼び出し時に実行される Update(DataSet) を取得または設定します。 |
Errors |
Command が実行されたときに .NET データ プロバイダーによって生成されたエラーを取得します。 (継承元 RowUpdatedEventArgs) |
RecordsAffected |
SQL ステートメントの実行によって変更、挿入、または削除された行の数を取得します。 (継承元 RowUpdatedEventArgs) |
Row |
DataRow を通じて送信された Update(DataSet) を取得します。 (継承元 RowUpdatedEventArgs) |
RowCount |
バッチでの更新済みレコードで処理された行数を取得します。 (継承元 RowUpdatedEventArgs) |
StatementType |
実行された SQL ステートメントの種類を取得します。 (継承元 RowUpdatedEventArgs) |
Status |
UpdateStatus プロパティの Command を取得します。 (継承元 RowUpdatedEventArgs) |
TableMapping |
DataTableMapping を通じて送信された Update(DataSet) を取得します。 (継承元 RowUpdatedEventArgs) |
メソッド
CopyToRows(DataRow[], Int32) |
指定した配列に、変更された行の参照をコピーします。 (継承元 RowUpdatedEventArgs) |
CopyToRows(DataRow[]) |
指定した配列に、変更された行の参照をコピーします。 (継承元 RowUpdatedEventArgs) |
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
適用対象
こちらもご覧ください
.NET