DbDataAdapter.Update Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w DataSet.
Przeciążenia
Update(DataSet, String) |
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w DataSet o określonej nazwie DataTable. |
Update(DataRow[], DataTableMapping) |
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonej tablicy obiektów DataRow. |
Update(DataTable) |
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonym DataTable. |
Update(DataSet) |
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonym DataSet. |
Update(DataRow[]) |
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonej tablicy w DataSet. |
Update(DataSet, String)
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
public:
int Update(System::Data::DataSet ^ dataSet, System::String ^ srcTable);
public int Update (System.Data.DataSet dataSet, string srcTable);
override this.Update : System.Data.DataSet * string -> int
Public Function Update (dataSet As DataSet, srcTable As String) As Integer
Parametry
- srcTable
- String
Nazwa tabeli źródłowej do użycia na potrzeby mapowania tabel.
Zwraca
Liczba wierszy pomyślnie zaktualizowanych z DataSet.
Wyjątki
DataSet jest nieprawidłowy.
Tabela źródłowa jest nieprawidłowa.
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 OleDbDataAdapter, aby zaktualizować źródło danych.
public DataSet CreateCmdsAndUpdate(string connectionString,
string queryString, string tableName)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
adapter.SelectCommand = new OleDbCommand(queryString, connection);
OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);
connection.Open();
DataSet customers = new DataSet();
adapter.Fill(customers);
//code to modify data in dataset here
adapter.Update(customers, tableName);
return customers;
}
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
ByVal queryString As String, _
ByVal tableName As String) As DataSet
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter()
adapter.SelectCommand = New OleDbCommand(queryString, connection)
Dim builder As New OleDbCommandBuilder(adapter)
connection.Open()
Dim customers As New DataSet()
adapter.Fill(customers)
' Code to modify data in DataSet here
adapter.Update(customers, tableName)
Return customers
End Using
End Function
Uwagi
Gdy aplikacja wywołuje metodę Update, DbDataAdapter sprawdza właściwość RowState i wykonuje wymagane instrukcje INSERT, UPDATE lub DELETE iteracyjne dla każdego wiersza na podstawie kolejności indeksów skonfigurowanych w 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 DataTable.
Należy zauważyć, że te instrukcje nie są wykonywane jako proces wsadowy; każdy wiersz jest aktualizowany indywidualnie. Aplikacja może wywołać metodę GetChanges w sytuacjach, w których należy kontrolować sekwencję typów instrukcji (na przykład INSERT przed aktualizacją). 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, metoda Update generuje wyjątek. Można jednak utworzyć obiekt SqlCommandBuilder lub OleDbCommandBuilder, aby automatycznie generować instrukcje SQL dla aktualizacji z jedną tabelą, jeśli ustawisz właściwość SelectCommand
dostawcy danych programu .NET Framework. Następnie wszystkie dodatkowe instrukcje SQL, które nie zostały ustawione, są generowane przez CommandBuilder. Ta logika generowania wymaga obecności informacji o kolumnie klucza w DataSet. Aby uzyskać więcej informacji, zobacz Generowanie poleceń za pomocą poleceń CommandBuilders.
Metoda Update obsługuje scenariusze, w których DataSet zawiera wiele obiektów DataTable, których nazwy różnią się tylko wielkością liter. Jeśli w DataSet
istnieje wiele tabel o tej samej nazwie, ale różne przypadki, Update wykonuje porównanie z uwzględnieniem wielkości liter, aby znaleźć odpowiednią tabelę, i generuje wyjątek, jeśli nie istnieje dokładne dopasowanie. Poniższy kod w języku C# ilustruje to zachowanie.
DataSet ds = new DataSet();
ds.Tables.Add("aaa");
ds.Tables.Add("AAA");
adapter.Update(ds, "aaa"); // Updates "aaa", which already exists in the DataSet.
adapter.Update(ds, "AAA"); // Updates "AAA", which already exists in the DataSet.
adapter.Update(ds, "Aaa"); // Results in an exception.
Jeśli Update jest wywoływana, a DataSet zawiera tylko jeden DataTable, którego nazwa różni się tylko wielkością liter, DataTable jest aktualizowana. W tym scenariuszu porównanie nie uwzględnia wielkości liter. Poniższy kod w języku C# ilustruje to zachowanie.
DataSet dataset = new DataSet();
dataset.Tables.Add("aaa");
adapter.Update(dataset, "AAA"); // Updates table "aaa" because only one similarly named table is in the DataSet.
Metoda Update pobiera wiersze z tabeli wymienionej w pierwszym mapowaniu przed wykonaniem aktualizacji. Następnie Update odświeża wiersz przy użyciu wartości właściwości UpdatedRowSource. Wszystkie zwracane dodatkowe wiersze są ignorowane.
Po załadowaniu wszystkich danych z powrotem do DataSetzostanie zgłoszone zdarzenie OnRowUpdated, co umożliwia użytkownikowi sprawdzenie uzgodnionego wiersza DataSet i wszystkich parametrów wyjściowych zwróconych przez polecenie . Po pomyślnym zaktualizowaniu wiersza zmiany w tym wierszu zostaną zaakceptowane.
W przypadku korzystania z Updatekolejność wykonywania jest następująca:
Wartości w DataRow są przenoszone do wartości parametrów.
Zdarzenie OnRowUpdating jest zgłaszane.
Polecenie jest wykonywane.
Jeśli polecenie ma wartość
FirstReturnedRecord
, pierwszy zwrócony wynik zostanie umieszczony w DataRow.Jeśli istnieją parametry wyjściowe, są one umieszczane w DataRow.
Zdarzenie OnRowUpdated jest zgłaszane.
AcceptChanges jest wywoływana.
Każde polecenie skojarzone z DbDataAdapter zwykle ma skojarzona kolekcja parametrów. Parametry są mapowane na bieżący wiersz za pomocą SourceColumn
i SourceVersion
właściwości Parameter
dostawcy danych programu .NET Framework.
SourceColumn
odnosi się do kolumny DataTable, do których DbDataAdapter 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 nieistnienej kolumny, podjęta akcja zależy od jednej z następujących wartości MissingMappingAction.
Wartość wyliczenia | Podjęto akcję |
---|---|
MissingMappingAction.Passthrough |
Jeśli nie ma mapowania, użyj nazw kolumn źródłowych i nazw tabel w DataSet. |
MissingMappingAction.Ignore |
Generowany jest SystemException. Gdy mapowania są jawnie ustawione, brakujące mapowanie parametru wejściowego jest zwykle wynikiem błędu. |
MissingMappingAction.Error |
Generowany jest SystemException. |
Właściwość SourceColumn
jest również używana do mapowania wartości parametrów wyjściowych lub wejściowych/wyjściowych z powrotem na DataSet
. Wyjątek jest generowany, jeśli odwołuje się do nieistnienej kolumny.
Właściwość SourceVersion
dostawcy danych platformy .NET Framework Parameter
określa, czy należy użyć wartości kolumny Oryginalna, Bieżąca lub Proponowana. 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.
Nuta
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 po napotkaniu błędu, ustaw właściwość ContinueUpdateOnError na true
przed wywołaniem Update. Możesz również reagować na błędy dla poszczególnych wierszy w ramach zdarzenia RowUpdated
elementu DataAdapter. Aby kontynuować operację aktualizacji bez generowania wyjątku w zdarzeniu RowUpdated
, ustaw właściwość StatusRowUpdatedEventArgs na wartość Continue.
Zobacz też
Dotyczy
Update(DataRow[], DataTableMapping)
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonej tablicy obiektów DataRow.
protected:
virtual int Update(cli::array <System::Data::DataRow ^> ^ dataRows, System::Data::Common::DataTableMapping ^ tableMapping);
protected virtual int Update (System.Data.DataRow[] dataRows, System.Data.Common.DataTableMapping tableMapping);
override this.Update : System.Data.DataRow[] * System.Data.Common.DataTableMapping -> int
Protected Overridable Function Update (dataRows As DataRow(), tableMapping As DataTableMapping) As Integer
Parametry
- tableMapping
- DataTableMapping
Kolekcja TableMappings do użycia.
Zwraca
Liczba wierszy pomyślnie zaktualizowanych z tablicy obiektów DataRow.
Wyjątki
DataSet jest nieprawidłowy.
Tabela źródłowa jest nieprawidłowa.
Nie istnieje DataRow aktualizacji.
-lub-
Nie istnieje DataTable aktualizacji.
-lub-
Nie istnieje DataSet do użycia jako źródło.
Próba wykonania instrukcji INSERT, UPDATE lub DELETE spowodowała zero rekordów, których dotyczy problem.
Uwagi
Gdy aplikacja wywołuje metodę Update, DbDataAdapter sprawdza właściwość RowState i wykonuje wymagane instrukcje INSERT, UPDATE lub DELETE iteracyjne dla każdego wiersza na podstawie kolejności indeksów skonfigurowanych w 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 DataTable.
Należy zauważyć, że te instrukcje nie są wykonywane jako proces wsadowy; każdy wiersz jest aktualizowany indywidualnie. Aplikacja może wywołać metodę GetChanges w sytuacjach, w których należy 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, metoda Update generuje wyjątek. Można jednak utworzyć obiekt SqlCommandBuilder lub OleDbCommandBuilder, aby automatycznie generować instrukcje SQL dla aktualizacji z jedną tabelą, jeśli ustawisz właściwość SelectCommand
dostawcy danych programu .NET Framework. Następnie wszystkie dodatkowe instrukcje SQL, które nie zostały ustawione, są generowane przez CommandBuilder. Ta logika generowania wymaga obecności informacji o kolumnie klucza w 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 odświeża wiersz przy użyciu wartości właściwości UpdatedRowSource. Wszystkie zwracane dodatkowe wiersze są ignorowane.
Po załadowaniu wszystkich danych z powrotem do DataSetzostanie zgłoszone zdarzenie OnRowUpdated, co umożliwia użytkownikowi sprawdzenie uzgodnionego wiersza DataSet i wszystkich parametrów wyjściowych zwróconych przez polecenie . Po pomyślnym zaktualizowaniu wiersza zmiany w tym wierszu zostaną zaakceptowane.
W przypadku korzystania z Updatekolejność wykonywania jest następująca:
Wartości w DataRow są przenoszone do wartości parametrów.
Zdarzenie OnRowUpdating jest zgłaszane.
Polecenie jest wykonywane.
Jeśli polecenie ma wartość
FirstReturnedRecord
, pierwszy zwrócony wynik zostanie umieszczony w DataRow.Jeśli istnieją parametry wyjściowe, są one umieszczane w DataRow.
Zdarzenie OnRowUpdated jest zgłaszane.
AcceptChanges jest wywoływana.
Każde polecenie skojarzone z DbDataAdapter zwykle ma skojarzona kolekcja parametrów. Parametry są mapowane na bieżący wiersz za pomocą SourceColumn
i SourceVersion
właściwości Parameter
dostawcy danych programu .NET Framework.
SourceColumn
odnosi się do kolumny DataTable, do których DbDataAdapter 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 nieistnienej kolumny, podjęta akcja zależy od jednej z następujących wartości MissingMappingAction.
Wartość wyliczenia | Podjęto akcję |
---|---|
MissingMappingAction.Passthrough |
Jeśli nie ma mapowania, użyj nazw kolumn źródłowych i nazw tabel w DataSet. |
MissingMappingAction.Ignore |
Generowany jest SystemException. Gdy mapowania są jawnie ustawione, brakujące mapowanie parametru wejściowego jest zwykle wynikiem błędu. |
MissingMappingAction.Error |
Generowany jest SystemException. |
Właściwość SourceColumn
jest również używana do mapowania wartości parametrów wyjściowych lub wejściowych/wyjściowych z powrotem na DataSet
. Wyjątek jest generowany, jeśli odwołuje się do nieistnienej kolumny.
Właściwość SourceVersion
dostawcy danych platformy .NET Framework Parameter
określa, czy należy użyć wartości kolumny Oryginalna, Bieżąca lub Proponowana. 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.
Nuta
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 po napotkaniu błędu, ustaw właściwość ContinueUpdateOnError na true
przed wywołaniem Update. Możesz również reagować na błędy dla poszczególnych wierszy w ramach zdarzenia RowUpdated
elementu DataAdapter. Aby kontynuować operację aktualizacji bez generowania wyjątku w zdarzeniu RowUpdated
, ustaw właściwość StatusRowUpdatedEventArgs na wartość Continue.
Zobacz też
Dotyczy
Update(DataTable)
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonym DataTable.
public:
int Update(System::Data::DataTable ^ dataTable);
public int Update (System.Data.DataTable dataTable);
override this.Update : System.Data.DataTable -> int
Public Function Update (dataTable As DataTable) As Integer
Parametry
Zwraca
Liczba wierszy pomyślnie zaktualizowanych z DataTable.
Wyjątki
DataSet jest nieprawidłowy.
Tabela źródłowa jest nieprawidłowa.
Nie istnieje DataRow aktualizacji.
-lub-
Nie istnieje DataTable aktualizacji.
-lub-
Nie istnieje DataSet do użycia jako źródło.
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 OleDbDataAdapter, aby zaktualizować źródło danych.
public DataTable CreateCmdsAndUpdate(string connectionString,
string queryString)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
adapter.SelectCommand = new OleDbCommand(queryString, connection);
OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);
connection.Open();
DataTable customers = new DataTable();
adapter.Fill(customers);
// code to modify data in DataTable here
adapter.Update(customers);
return customers;
}
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
ByVal queryString As String) As DataTable
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter()
adapter.SelectCommand = New OleDbCommand(queryString, connection)
Dim builder As New OleDbCommandBuilder(adapter)
connection.Open()
Dim customers As New DataTable()
adapter.Fill(customers)
' Code to modify data in DataTable here
adapter.Update(customers)
Return customers
End Using
End Function
Uwagi
Gdy aplikacja wywołuje metodę Update, DbDataAdapter sprawdza właściwość RowState i wykonuje wymagane instrukcje INSERT, UPDATE lub DELETE iteracyjne dla każdego wiersza na podstawie kolejności indeksów skonfigurowanych w 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 DataTable.
Należy zauważyć, że te instrukcje nie są wykonywane jako proces wsadowy; każdy wiersz jest aktualizowany indywidualnie. Aplikacja może wywołać metodę GetChanges w sytuacjach, w których należy 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, metoda Update generuje wyjątek. Można jednak utworzyć obiekt SqlCommandBuilder lub OleDbCommandBuilder, aby automatycznie generować instrukcje SQL dla aktualizacji z jedną tabelą, jeśli ustawisz właściwość SelectCommand
dostawcy danych programu .NET Framework. Następnie wszystkie dodatkowe instrukcje SQL, które nie zostały ustawione, są generowane przez CommandBuilder. Ta logika generowania wymaga obecności informacji o kolumnie klucza w 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 odświeża wiersz przy użyciu wartości właściwości UpdatedRowSource. Wszystkie zwracane dodatkowe wiersze są ignorowane.
Po załadowaniu wszystkich danych z powrotem do DataSetzostanie zgłoszone zdarzenie OnRowUpdated, co umożliwia użytkownikowi sprawdzenie uzgodnionego wiersza DataSet i wszystkich parametrów wyjściowych zwróconych przez polecenie . Po pomyślnym zaktualizowaniu wiersza zmiany w tym wierszu zostaną zaakceptowane.
W przypadku korzystania z Updatekolejność wykonywania jest następująca:
Wartości w DataRow są przenoszone do wartości parametrów.
Zdarzenie OnRowUpdating jest zgłaszane.
Polecenie jest wykonywane.
Jeśli polecenie ma wartość
FirstReturnedRecord
, pierwszy zwrócony wynik zostanie umieszczony w DataRow.Jeśli istnieją parametry wyjściowe, są one umieszczane w DataRow.
Zdarzenie OnRowUpdated jest zgłaszane.
AcceptChanges jest wywoływana.
Każde polecenie skojarzone z DbDataAdapter zwykle ma skojarzona kolekcja parametrów. Parametry są mapowane na bieżący wiersz za pomocą SourceColumn
i SourceVersion
właściwości Parameter
dostawcy danych programu .NET Framework.
SourceColumn
odnosi się do kolumny DataTable, do których DbDataAdapter 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 nieistnienej kolumny, podjęta akcja zależy od jednej z następujących wartości MissingMappingAction.
Wartość wyliczenia | Podjęto akcję |
---|---|
MissingMappingAction.Passthrough |
Jeśli nie ma mapowania, użyj nazw kolumn źródłowych i nazw tabel w DataSet. |
MissingMappingAction.Ignore |
Generowany jest SystemException. Gdy mapowania są jawnie ustawione, brakujące mapowanie parametru wejściowego jest zwykle wynikiem błędu. |
MissingMappingAction.Error |
Generowany jest SystemException. |
Właściwość SourceColumn
jest również używana do mapowania wartości parametrów wyjściowych lub wejściowych/wyjściowych z powrotem na DataSet
. Wyjątek jest generowany, jeśli odwołuje się do nieistnienej kolumny.
Właściwość SourceVersion
dostawcy danych platformy .NET Framework Parameter
określa, czy należy użyć wartości kolumny Oryginalna, Bieżąca lub Proponowana. 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.
Nuta
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 po napotkaniu błędu, ustaw właściwość ContinueUpdateOnError na true
przed wywołaniem Update. Możesz również reagować na błędy dla poszczególnych wierszy w ramach zdarzenia RowUpdated
elementu DataAdapter. Aby kontynuować operację aktualizacji bez generowania wyjątku w zdarzeniu RowUpdated
, ustaw właściwość StatusRowUpdatedEventArgs na wartość Continue.
Zobacz też
Dotyczy
Update(DataSet)
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonym DataSet.
public:
override int Update(System::Data::DataSet ^ dataSet);
public override int Update (System.Data.DataSet dataSet);
override this.Update : System.Data.DataSet -> int
Public Overrides Function Update (dataSet As DataSet) As Integer
Parametry
Zwraca
Liczba wierszy pomyślnie zaktualizowanych z DataSet.
Implementuje
Wyjątki
Tabela źródłowa jest nieprawidłowa.
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 OleDbDataAdapter, aby zaktualizować źródło danych.
public DataSet CreateCmdsAndUpdate(string connectionString,
string queryString)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
adapter.SelectCommand = new OleDbCommand(queryString, connection);
OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);
connection.Open();
DataSet customers = new DataSet();
adapter.Fill(customers);
//code to modify data in dataset here
adapter.Update(customers);
return customers;
}
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter()
adapter.SelectCommand = New OleDbCommand(queryString, connection)
Dim builder As New OleDbCommandBuilder(adapter)
connection.Open()
Dim customers As New DataSet()
adapter.Fill(customers)
' Code to modify data in DataSet here
adapter.Update(customers)
Return customers
End Using
End Function
Uwagi
Gdy aplikacja wywołuje metodę Update, DbDataAdapter sprawdza właściwość RowState i wykonuje wymagane instrukcje INSERT, UPDATE lub DELETE iteracyjne dla każdego wiersza na podstawie kolejności indeksów skonfigurowanych w 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 DataTable.
Należy zauważyć, że te instrukcje nie są wykonywane jako proces wsadowy; każdy wiersz jest aktualizowany indywidualnie. Aplikacja może wywołać metodę GetChanges w sytuacjach, w których należy 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, metoda Update generuje wyjątek. Można jednak utworzyć obiekt SqlCommandBuilder lub OleDbCommandBuilder, aby automatycznie generować instrukcje SQL dla aktualizacji z jedną tabelą, jeśli ustawisz właściwość SelectCommand
dostawcy danych programu .NET Framework. Następnie wszystkie dodatkowe instrukcje SQL, które nie zostały ustawione, są generowane przez CommandBuilder. Ta logika generowania wymaga obecności informacji o kolumnie klucza w 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 odświeża wiersz przy użyciu wartości właściwości UpdatedRowSource. Wszystkie zwracane dodatkowe wiersze są ignorowane.
Po załadowaniu wszystkich danych z powrotem do DataSetzostanie zgłoszone zdarzenie OnRowUpdated, co umożliwia użytkownikowi sprawdzenie uzgodnionego wiersza DataSet i wszystkich parametrów wyjściowych zwróconych przez polecenie . Po pomyślnym zaktualizowaniu wiersza zmiany w tym wierszu zostaną zaakceptowane.
W przypadku korzystania z Updatekolejność wykonywania jest następująca:
Wartości w DataRow są przenoszone do wartości parametrów.
Zdarzenie OnRowUpdating jest zgłaszane.
Polecenie jest wykonywane.
Jeśli polecenie ma wartość
FirstReturnedRecord
, pierwszy zwrócony wynik zostanie umieszczony w DataRow.Jeśli istnieją parametry wyjściowe, są one umieszczane w DataRow.
Zdarzenie OnRowUpdated jest zgłaszane.
AcceptChanges jest wywoływana.
Każde polecenie skojarzone z DbDataAdapter zwykle ma skojarzona kolekcja parametrów. Parametry są mapowane na bieżący wiersz za pomocą SourceColumn
i SourceVersion
właściwości Parameter
dostawcy danych programu .NET Framework.
SourceColumn
odnosi się do kolumny DataTable, do których DbDataAdapter 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 nieistnienej kolumny, podjęta akcja zależy od jednej z następujących wartości MissingMappingAction.
Wartość wyliczenia | Podjęto akcję |
---|---|
MissingMappingAction.Passthrough |
Jeśli nie ma mapowania, użyj nazw kolumn źródłowych i nazw tabel w DataSet. |
MissingMappingAction.Ignore |
Generowany jest SystemException. Gdy mapowania są jawnie ustawione, brakujące mapowanie parametru wejściowego jest zwykle wynikiem błędu. |
MissingMappingAction.Error |
Generowany jest SystemException. |
Właściwość SourceColumn
jest również używana do mapowania wartości parametrów wyjściowych lub wejściowych/wyjściowych z powrotem na DataSet
. Wyjątek jest generowany, jeśli odwołuje się do nieistnienej kolumny.
Właściwość SourceVersion
dostawcy danych platformy .NET Framework Parameter
określa, czy należy użyć wartości kolumny Oryginalna, Bieżąca lub Proponowana. 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.
Nuta
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 po napotkaniu błędu, ustaw właściwość ContinueUpdateOnError na true
przed wywołaniem Update. Możesz również reagować na błędy dla poszczególnych wierszy w ramach zdarzenia RowUpdated
elementu DataAdapter. Aby kontynuować operację aktualizacji bez generowania wyjątku w zdarzeniu RowUpdated
, ustaw właściwość StatusRowUpdatedEventArgs na wartość Continue.
Zobacz też
Dotyczy
Update(DataRow[])
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
- Źródło:
- DbDataAdapter.cs
Aktualizuje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w określonej tablicy w DataSet.
public:
int Update(cli::array <System::Data::DataRow ^> ^ dataRows);
public int Update (System.Data.DataRow[] dataRows);
override this.Update : System.Data.DataRow[] -> int
Public Function Update (dataRows As DataRow()) As Integer
Parametry
Zwraca
Liczba wierszy pomyślnie zaktualizowanych z DataSet.
Wyjątki
DataSet jest nieprawidłowy.
Tabela źródłowa jest nieprawidłowa.
Nie istnieje DataRow aktualizacji.
-lub-
Nie istnieje DataTable aktualizacji.
-lub-
Nie istnieje DataSet do użycia jako źródło.
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 OleDbDataAdapter, aby zaktualizować źródło danych.
public DataSet CreateCmdsAndUpdate(string connectionString,
string queryString)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
adapter.SelectCommand = new OleDbCommand(queryString, connection);
OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);
connection.Open();
DataSet customers = new DataSet();
adapter.Fill(customers);
//code to modify data in dataset here
//Insert new records from DataSet
DataRow[] rows = customers.Tables[0].Select(
null, null, DataViewRowState.Added);
adapter.Update(rows);
return customers;
}
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter()
adapter.SelectCommand = New OleDbCommand(queryString, connection)
Dim builder As New OleDbCommandBuilder(adapter)
connection.Open()
Dim customers As New DataSet()
adapter.Fill(customers)
' Code to modify data in DataSet here
' Insert new records from DataSet
Dim rows() As DataRow = customers.Tables(0).Select( _
Nothing, Nothing, DataViewRowState.Added)
adapter.Update(rows)
Return customers
End Using
End Function
Uwagi
Gdy aplikacja wywołuje metodę Update, DbDataAdapter sprawdza właściwość RowState i wykonuje wymagane instrukcje INSERT, UPDATE lub DELETE iteracyjne dla każdego wiersza na podstawie kolejności indeksów skonfigurowanych w 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 DataTable.
Należy zauważyć, że te instrukcje nie są wykonywane jako proces wsadowy; każdy wiersz jest aktualizowany indywidualnie. Aplikacja może wywołać metodę GetChanges w sytuacjach, w których należy 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, metoda Update generuje wyjątek. Można jednak utworzyć obiekt SqlCommandBuilder lub OleDbCommandBuilder, aby automatycznie generować instrukcje SQL dla aktualizacji z jedną tabelą, jeśli ustawisz właściwość SelectCommand
dostawcy danych programu .NET Framework. Następnie wszystkie dodatkowe instrukcje SQL, które nie zostały ustawione, są generowane przez CommandBuilder. Ta logika generowania wymaga obecności informacji o kolumnie klucza w 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 odświeża wiersz przy użyciu wartości właściwości UpdatedRowSource. Wszystkie zwracane dodatkowe wiersze są ignorowane.
Po załadowaniu wszystkich danych z powrotem do DataSetzostanie zgłoszone zdarzenie OnRowUpdated, co umożliwia użytkownikowi sprawdzenie uzgodnionego wiersza DataSet i wszystkich parametrów wyjściowych zwróconych przez polecenie . Po pomyślnym zaktualizowaniu wiersza zmiany w tym wierszu zostaną zaakceptowane.
W przypadku korzystania z Updatekolejność wykonywania jest następująca:
Wartości w DataRow są przenoszone do wartości parametrów.
Zdarzenie OnRowUpdating jest zgłaszane.
Polecenie jest wykonywane.
Jeśli polecenie jest ustawione na
FirstReturnedRecord
, pierwszy zwrócony wynik zostanie umieszczony w DataRow.Jeśli istnieją parametry wyjściowe, są one umieszczane w DataRow.
Zdarzenie OnRowUpdated jest zgłaszane.
AcceptChanges jest wywoływana.
Każde polecenie skojarzone z DbDataAdapter zwykle ma skojarzona kolekcja parametrów. Parametry są mapowane na bieżący wiersz za pomocą SourceColumn
i SourceVersion
właściwości Parameter
dostawcy danych programu .NET Framework.
SourceColumn
odnosi się do kolumny DataTable, do których DbDataAdapter 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 nieistnienej kolumny, podjęta akcja zależy od jednej z następujących wartości MissingMappingAction.
Wartość wyliczenia | Podjęto akcję |
---|---|
MissingMappingAction.Passthrough |
Jeśli nie ma mapowania, użyj nazw kolumn źródłowych i nazw tabel w DataSet. |
MissingMappingAction.Ignore |
Generowany jest SystemException. Gdy mapowania są jawnie ustawione, brakujące mapowanie parametru wejściowego jest zwykle wynikiem błędu. |
MissingMappingAction.Error |
Generowany jest SystemException. |
Właściwość SourceColumn
jest również używana do mapowania wartości parametrów wyjściowych lub wejściowych/wyjściowych z powrotem na DataSet
. Wyjątek jest generowany, jeśli odwołuje się do nieistnienej kolumny.
Właściwość SourceVersion
dostawcy danych platformy .NET Framework Parameter
określa, czy należy użyć wartości kolumny Oryginalna, Bieżąca lub Proponowana. 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.
Nuta
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 po napotkaniu błędu, ustaw właściwość ContinueUpdateOnError na true
przed wywołaniem Update. Możesz również reagować na błędy dla poszczególnych wierszy w ramach zdarzenia RowUpdated
elementu DataAdapter. Aby kontynuować operację aktualizacji bez generowania wyjątku w zdarzeniu RowUpdated
, ustaw właściwość StatusRowUpdatedEventArgs na wartość Continue.