SqlRowUpdatedEventArgs Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Innehåller data för RowUpdated händelsen.
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
- Arv
Exempel
I följande exempel visas hur du använder både RowUpdating händelserna och RowUpdated .
Händelsen RowUpdating returnerar följande utdata:
Händelseargument: (command=System.Data.SqlClient.SqlCommand commandType=2 status=0)
Händelsen RowUpdated returnerar följande utdata:
Händelseargument: (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 = "...";
const string queryString = "SELECT * FROM Products";
// create DataAdapter
SqlDataAdapter adapter = new(queryString, connectionString);
SqlCommandBuilder builder = new(adapter);
// Create and fill DataSet (select only first 5 rows)
DataSet dataSet = new();
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
Public Overloads Shared Function Main(args() As String) As Integer
Const connectionString As String = "..."
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
Private Overloads 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
Private Overloads 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
Kommentarer
Händelsen RowUpdated utlöses när en Update till en rad har slutförts.
När du använder Updatefinns det två händelser som inträffar för varje datarad som uppdateras. Körningsordningen är följande:
Värdena i DataRow flyttas till parametervärdena.
Händelsen OnRowUpdating aktiveras.
Kommandot körs.
Om kommandot är inställt på
FirstReturnedRecord, och det första returnerade resultatet placeras i DataRow.Om det finns utdataparametrar placeras de i DataRow.
Händelsen OnRowUpdated aktiveras.
AcceptChanges kallas.
Konstruktorer
| Name | Description |
|---|---|
| SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping) |
Initierar en ny instans av SqlRowUpdatedEventArgs klassen. |
Egenskaper
| Name | Description |
|---|---|
| Command |
Hämtar eller anger körningen SqlCommand när Update(DataSet) anropas. |
| Errors |
Hämtar eventuella fel som genereras av .NET dataprovidern när Command kördes. (Ärvd från RowUpdatedEventArgs) |
| RecordsAffected |
Hämtar antalet rader som har ändrats, infogats eller tagits bort genom körning av SQL-instruktionen. (Ärvd från RowUpdatedEventArgs) |
| Row |
Hämtar skickade DataRow via en Update(DataSet). (Ärvd från RowUpdatedEventArgs) |
| RowCount |
Hämtar antalet rader som bearbetas i en batch med uppdaterade poster. (Ärvd från RowUpdatedEventArgs) |
| StatementType |
Hämtar den typ av SQL-instruktion som körs. (Ärvd från RowUpdatedEventArgs) |
| Status |
UpdateStatus Command Hämtar egenskapen. (Ärvd från RowUpdatedEventArgs) |
| TableMapping |
Hämtar skickade DataTableMapping via en Update(DataSet). (Ärvd från RowUpdatedEventArgs) |
Metoder
| Name | Description |
|---|---|
| CopyToRows(DataRow[], Int32) |
Kopierar referenser till de ändrade raderna till den angivna matrisen. (Ärvd från RowUpdatedEventArgs) |
| CopyToRows(DataRow[]) |
Kopierar referenser till de ändrade raderna till den angivna matrisen. (Ärvd från RowUpdatedEventArgs) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |