IDataAdapter.Update(DataSet) Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestawy:

netstandard.dll, System.Data.Common.dll

Źródło:

IDataAdapter.cs

Wywołuje odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonym DataSet z nazwanej DataTable tabeli.

public:
 int Update(System::Data::DataSet ^ dataSet);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")]
public int Update(System.Data.DataSet dataSet);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")>]
abstract member Update : System.Data.DataSet -> int

Public Function Update (dataSet As DataSet) As Integer

Parametry

dataSet

DataSet

Element DataSet używany do aktualizowania źródła danych.

Zwraca

Int32

Liczba wierszy pomyślnie zaktualizowanych z elementu DataSet.

Atrybuty

RequiresUnreferencedCodeAttribute

Wyjątki

DBConcurrencyException

Próba wykonania instrukcji INSERT, UPDATE lub DELETE spowodowała zero rekordów, których dotyczy problem.

Przykłady

W poniższym przykładzie użyto klasy pochodnej , OleDbDataAdapterdo Update źródła danych. W tym przykładzie przyjęto założenie, że utworzono obiekt OleDbDataAdapter i DataSet.

static private DataSet CreateCommandAndUpdate(
    string connectionString,
    string queryString)
{
    DataSet dataSet = new DataSet();

    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbDataAdapter adapter =
            new OleDbDataAdapter();
        adapter.SelectCommand =
            new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder =
            new OleDbCommandBuilder(adapter);

        adapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        // Without the OleDbCommandBuilder, this line would fail.
        adapter.UpdateCommand = builder.GetUpdateCommand();
        adapter.Update(dataSet);
    }
    return dataSet;
}

Public Function CreateCommandAndUpdate( _
    ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim adapter As New OleDbDataAdapter()

        adapter.SelectCommand = New OleDbCommand( _
            queryString, connection)

        Dim builder As OleDbCommandBuilder = _
            New OleDbCommandBuilder(adapter)

        adapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        builder.GetUpdateCommand()
        adapter.Update(dataSet)
    End Using
    Return dataSet
End Function

Uwagi

Gdy aplikacja wywołuje Update metodę, IDataAdapter funkcja sprawdza RowState właściwość i wykonuje wymagane instrukcje INSERT, UPDATE lub DELETE iteracyjne dla każdego wiersza na podstawie kolejności indeksów skonfigurowanych w obiekcie DataSet. Na przykład Update może wykonać instrukcję DELETE, a następnie instrukcję INSERT, a następnie inną instrukcję DELETE ze względu na kolejność wierszy w DataTableobiekcie .

Należy pamiętać, że te instrukcje nie są wykonywane jako proces wsadowy; każdy wiersz jest aktualizowany indywidualnie. Aplikacja może wywołać metodę GetChanges , jeśli musisz kontrolować sekwencję typów instrukcji (na przykład INSERTs przed UPDATEs). Aby uzyskać więcej informacji, zobacz Aktualizowanie źródeł danych za pomocą elementów DataAdapters.

Jeśli instrukcje INSERT, UPDATE lub DELETE nie zostały określone, Update metoda generuje wyjątek. Można jednak utworzyć SqlCommandBuilder obiekt lub OleDbCommandBuilder w celu automatycznego generowania instrukcji SQL dla aktualizacji z jedną tabelą, jeśli ustawisz SelectCommand właściwość dostawcy danych programu .NET Framework. Następnie wszystkie dodatkowe instrukcje SQL, które nie zostały ustawione, są generowane przez narzędzie CommandBuilder. Ta logika generowania wymaga obecności informacji o kolumnie klucza w obiekcie DataSet. Aby uzyskać więcej informacji, zobacz Generowanie poleceń za pomocą poleceń CommandBuilders.

Metoda Update pobiera wiersze z tabeli wymienionej w pierwszym mapowaniu przed wykonaniem aktualizacji. Następnie Update aktualizuje wiersz przy użyciu wartości UpdatedRowSource właściwości . Wszystkie zwracane dodatkowe wiersze są ignorowane.

Po załadowaniu DataSetOnRowUpdated wszystkich danych z powrotem do zdarzenia jest wywoływane, co umożliwia użytkownikowi sprawdzenie uzgadnianego DataSet wiersza i wszystkich parametrów wyjściowych zwróconych przez polecenie . Po pomyślnym zaktualizowaniu wiersza zmiany w tym wierszu zostaną zaakceptowane.

W przypadku używania polecenia Updatekolejność 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 jest ustawione na FirstReturnedRecordwartość , pierwszy zwrócony wynik zostanie umieszczony w elemecie DataRow.

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

6. Zdarzenie OnRowUpdated jest zgłaszane.

7. AcceptChanges jest wywoływane.

Każde polecenie skojarzone z obiektem IDataAdapter zwykle ma skojarzona kolekcja parametrów. Parametry są mapowane na bieżący wiersz za pomocą SourceColumn właściwości i SourceVersion klasy dostawcy Parameter danych programu .NET Framework. SourceColumn odwołuje się do kolumny, do DataTable których IDataAdapter odwołuje się do uzyskiwania wartości parametrów dla bieżącego wiersza.

SourceColumn odwołuje się do niezamapowanej nazwy kolumny przed zastosowaniem mapowań tabeli. Jeśli SourceColumn odwołuje się do nieistniejących kolumn, podjęta akcja zależy od jednej z następujących MissingMappingAction wartości.

Wartość wyliczenia	Podjęto akcję
MissingMappingAction.Passthrough	Użyj nazw kolumn źródłowych i nazw tabel w tabeli DataSet , jeśli nie ma mapowania.
MissingMappingAction.Ignore	Zostanie wygenerowana wartość A SystemException . Gdy mapowania są jawnie ustawione, brakujące mapowanie parametru wejściowego jest zwykle spowodowane błędem.
MissingMappingAction.Error	Zostanie wygenerowana wartość A SystemException .

Właściwość SourceColumn jest również używana do mapowania wartości parametrów wyjściowych lub wejściowych/wyjściowych DataSetz powrotem na wartość . Wyjątek jest generowany, jeśli odwołuje się do nieistnienej kolumny.

Właściwość SourceVersion klasy dostawcy Parameter danych programu .NET Framework określa, czy należy użyć Originalwartości kolumny , Currentlub Proposed wersji. Ta funkcja jest często używana do uwzględnienia oryginalnych wartości w klauzuli WHERE instrukcji UPDATE w celu sprawdzenia pod kątem optymistycznych naruszeń współbieżności.

Uwaga / Notatka

Jeśli podczas aktualizowania wiersza wystąpi błąd, zgłaszany jest wyjątek, a wykonanie aktualizacji nie zostanie zakończone. Aby kontynuować operację aktualizacji bez generowania wyjątków w przypadku wystąpienia błędu, ustaw ContinueUpdateOnError właściwość na wartość true przed wywołaniem metody Update. Możesz również reagować na błędy dla poszczególnych wierszy w RowUpdated ramach zdarzenia dataAdapter. Aby kontynuować operację aktualizacji bez generowania wyjątku w zdarzeniu RowUpdated , ustaw Status właściwość elementu RowUpdatedEventArgs na Continue.