SqlRowUpdatedEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Udostępnia dane dla zdarzenia RowUpdated.

C#

public sealed class SqlRowUpdatedEventArgs : System.Data.Common.RowUpdatedEventArgs

Dziedziczenie

Object

EventArgs

RowUpdatedEventArgs

SqlRowUpdatedEventArgs

Przykłady

W poniższym przykładzie pokazano, jak używać zarówno zdarzeń, jak RowUpdating i RowUpdated .

Zdarzenie RowUpdating zwraca następujące dane wyjściowe:

Argumenty zdarzeń: (command=System.Data.SqlClient.SqlCommand commandType=2 status=0)

Zdarzenie RowUpdated zwraca następujące dane wyjściowe:

Argumenty zdarzeń: (command=System.Data.SqlClient.SqlCommand commandType=2 recordsAffected=1 row=System.Data.DataRow[37] status=0)

C#

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

Uwagi

Zdarzenie RowUpdated jest zgłaszane, gdy element do Update wiersza zostanie ukończony.

W przypadku korzystania z programu Updateistnieją dwa zdarzenia, które występują dla każdego zaktualizowanego wiersza danych. Kolejność wykonywania jest następująca:

1. Wartości w obiekcie DataRow są przenoszone do wartości parametrów.

2. Zdarzenie OnRowUpdating jest zgłaszane.

3. Polecenie jest wykonywane.

4. Jeśli polecenie jest ustawione na FirstReturnedRecordwartość , a pierwszy zwrócony wynik zostanie umieszczony w elemecie DataRow.

5. Jeśli istnieją parametry wyjściowe, są one umieszczane w elemecie DataRow.

6. Zdarzenie OnRowUpdated jest zgłaszane.

7. Wywołano metodę AcceptChanges.

Konstruktory

SqlRowUpdatedEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicjuje nowe wystąpienie klasy SqlRowUpdatedEventArgs.

Właściwości

Command	Pobiera lub ustawia SqlCommand wykonywane po Update(DataSet) wywołaniu.
Errors	Pobiera wszelkie błędy generowane przez dostawcę danych platformy .NET podczas Command wykonywania. (Odziedziczone po RowUpdatedEventArgs)
RecordsAffected	Pobiera liczbę wierszy zmienionych, wstawionych lub usuniętych przez wykonanie instrukcji SQL. (Odziedziczone po RowUpdatedEventArgs)
Row	DataRow Pobiera element wysyłany za pośrednictwem elementu Update(DataSet). (Odziedziczone po RowUpdatedEventArgs)
RowCount	Pobiera liczbę wierszy przetworzonych w partii zaktualizowanych rekordów. (Odziedziczone po RowUpdatedEventArgs)
StatementType	Pobiera typ wykonywanej instrukcji SQL. (Odziedziczone po RowUpdatedEventArgs)
Status	UpdateStatus Command Pobiera właściwość . (Odziedziczone po RowUpdatedEventArgs)
TableMapping	DataTableMapping Pobiera element wysyłany za pośrednictwem elementu Update(DataSet). (Odziedziczone po RowUpdatedEventArgs)

Metody

CopyToRows(DataRow[], Int32)	Kopiuje odwołania do zmodyfikowanych wierszy do dostarczonej tablicy. (Odziedziczone po RowUpdatedEventArgs)
CopyToRows(DataRow[])	Kopiuje odwołania do zmodyfikowanych wierszy do dostarczonej tablicy. (Odziedziczone po RowUpdatedEventArgs)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy

Zobacz też

• Omówienie ADO.NET