OleDbDataAdapter.RowUpdating Zdarzenie

Definicja

Występuje podczas Update(DataSet) wykonywania polecenia względem źródła danych. Podjęto próbę aktualizacji. W związku z tym zdarzenie występuje.

C#
public event System.Data.OleDb.OleDbRowUpdatingEventHandler? RowUpdating;
C#
[System.Data.DataSysDescription("DbDataAdapter_RowUpdating")]
public event System.Data.OleDb.OleDbRowUpdatingEventHandler RowUpdating;
C#
public event System.Data.OleDb.OleDbRowUpdatingEventHandler RowUpdating;

Typ zdarzenia

Atrybuty

Przykłady

W poniższym przykładzie przedstawiono RowUpdating używane zdarzenia i RowUpdated .

C#
public static void CreateDataAdapter(
    string connectionString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter(
            "SELECT * FROM Customers WHERE CustomerID = 'ALFKI'", connection);

        adapter.InsertCommand = new OleDbCommand(
            "INSERT INTO Customers (CustomerID, CompanyName) VALUES(?, ?)",
            connection);

        adapter.InsertCommand.Parameters.Add(
            "@CustomerID", OleDbType.VarChar, 5, "CustomerID");
        adapter.InsertCommand.Parameters.Add(
            "@CompanyName", OleDbType.VarChar, 30, "CompanyName");

        connection.Open();

        DataSet custDS = new DataSet();
        adapter.Fill(custDS, "Customers");

        DataRow custRow = custDS.Tables["Customers"].NewRow();
        custRow["CustomerID"] = "NEWCO";
        custRow["CompanyName"] = "New Company";
        custDS.Tables["Customers"].Rows.Add(custRow);

        // add handlers
        adapter.RowUpdating += new OleDbRowUpdatingEventHandler(OnRowUpdating);
        adapter.RowUpdated += new OleDbRowUpdatedEventHandler(OnRowUpdated);

        adapter.Update(custDS, "Customers");

        // remove handlers
        adapter.RowUpdating -= new OleDbRowUpdatingEventHandler(OnRowUpdating);
        adapter.RowUpdated -= new OleDbRowUpdatedEventHandler(OnRowUpdated);

        foreach (DataRow row in custDS.Tables["Customers"].Rows)
        {
            if (row.HasErrors)
                Console.WriteLine(row.RowError);
        }
    }
}

protected static void OnRowUpdating(object sender,
    OleDbRowUpdatingEventArgs args)
{
    if (args.StatementType == StatementType.Insert)
    {
        System.IO.TextWriter writer = System.IO.File.AppendText("Inserts.log");
        writer.WriteLine("{0}: Customer {1} Inserted.",
            DateTime.Now, args.Row["CustomerID"]);
        writer.Close();
    }
}

protected static void OnRowUpdated(object sender, OleDbRowUpdatedEventArgs args)
{
    if (args.Status == UpdateStatus.ErrorsOccurred)
    {
        args.Row.RowError = args.Errors.Message;
        args.Status = UpdateStatus.SkipCurrentRow;
    }
}

Uwagi

W przypadku korzystania z programu Updateistnieją dwa zdarzenia, które występują w poszczególnych wierszach danych. Kolejność wykonywania jest następująca:

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

  2. Zdarzenie OnRowUpdating jest zgłaszane.

  3. Polecenie jest wykonywane.

  4. Jeśli polecenie ma wartość FirstReturnedRecord, 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.

Dotyczy

Produkt Wersje
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Zobacz też