DbDataAdapter Klasa

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbDataAdapter.cs

Ułatwia implementację interfejsu IDbDataAdapter . Dziedziczenie DbDataAdapter implementowania zestawu funkcji w celu zapewnienia silnego wpisywania, ale dziedziczą większość funkcji potrzebnych do pełnego zaimplementowania elementu DataAdapter.

C#

public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter

Dziedziczenie

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

Pochodne

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Uwagi

Klasa DbDataAdapter dziedziczy z DataAdapter klasy i implementuje IDbDataAdapter interfejs. Pomaga to klasie zaimplementować klasę DataAdapter zaprojektowaną do użytku z relacyjną bazą danych.

Aplikacja nie tworzy bezpośrednio wystąpienia DbDataAdapter klasy, ale tworzy wystąpienie klasy dziedziczonej z niej.

Klasy dziedziczone DbDataAdapter muszą implementować dziedziczone elementy członkowskie i zazwyczaj definiują dodatkowe elementy członkowskie w celu dodania funkcji specyficznych dla dostawcy. Na przykład DbDataAdapter klasa definiuje SelectCommand właściwość, a DbDataAdapter klasa definiuje osiem przeciążeń Fill metody. Z kolei OleDbDataAdapter klasa dziedziczy metodę Fill , a także definiuje dwa dodatkowe przeciążenia, które przyjmują obiekt zestawu rekordów Fill ADO jako parametr.

Uwagi dotyczące implementowania

W przypadku dziedziczenia DbDataAdapter z klasy zalecamy zaimplementowanie następujących konstruktorów:

Element	Opis
*Prv*DataAdapter()	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter.
*Prv*DataAdapter(*Prv*Polecenie *selectCommand*)	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter z określoną instrukcją SQL SELECT.
*Prv*DataAdapter(ciąg *selectCommandText*, ciąg *selectConnectionString*)	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter z instrukcją SQL SELECT i parametry połączenia.
*Prv*DataAdapter(ciąg *selectCommandText*, *Prv*Connection *selectConnection*)	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter z instrukcją SQL SELECT i obiektem *Prv*Connection.

Aby podwyższyć spójność między dostawcami danych .NET Framework, należy nazwać klasę dziedziczą w postaci PrvDataAdapter, gdzie Prv jest jednolitym prefiksem podanym dla wszystkich klas w określonej przestrzeni nazw dostawcy danych .NET Framework. Na przykład "Sql" jest prefiksem SqlDataAdapter klasy w przestrzeni nazw System.Data.SqlClient .

Konstruktory

DbDataAdapter()	Inicjuje nowe wystąpienie klasy DataAdapter .
DbDataAdapter(DbDataAdapter)	Inicjuje DataAdapter nowe wystąpienie klasy z istniejącego obiektu tego samego typu.

Pola

DefaultSourceTableName

Domyślna nazwa używana przez DataAdapter obiekt do mapowania tabel.

Właściwości

AcceptChangesDuringFill	Pobiera lub ustawia wartość wskazującą, czy AcceptChanges() jest wywoływana na obiekcie DataRow po dodaniu do DataTable obiektu podczas dowolnej operacji Wypełnianie . (Odziedziczone po DataAdapter)
AcceptChangesDuringUpdate	Pobiera lub ustawia, czy AcceptChanges() jest wywoływany podczas .Update(DataSet) (Odziedziczone po DataAdapter)
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
ContinueUpdateOnError	Pobiera lub ustawia wartość określającą, czy należy wygenerować wyjątek w przypadku wystąpienia błędu podczas aktualizacji wiersza. (Odziedziczone po DataAdapter)
DeleteCommand	Pobiera lub ustawia polecenie usuwania rekordów z zestawu danych.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
FillCommandBehavior	Pobiera lub ustawia zachowanie polecenia użytego do wypełnienia karty danych.
FillLoadOption	Pobiera lub ustawia LoadOption element określający sposób wypełniania DataTable obiektu przez adapter z obiektu DbDataReader. (Odziedziczone po DataAdapter)
InsertCommand	Pobiera lub ustawia polecenie używane do wstawiania nowych rekordów do źródła danych.
MissingMappingAction	Określa akcję, która ma być wykonywana, gdy dane przychodzące nie mają zgodnej tabeli ani kolumny. (Odziedziczone po DataAdapter)
MissingSchemaAction	Określa akcję do wykonania, gdy istniejący DataSet schemat nie jest zgodny z danymi przychodzącymi. (Odziedziczone po DataAdapter)
ReturnProviderSpecificTypes	Pobiera lub ustawia, czy Fill metoda powinna zwracać wartości specyficzne dla dostawcy, czy typowe wartości zgodne ze specyfikacją CLS. (Odziedziczone po DataAdapter)
SelectCommand	Pobiera lub ustawia polecenie służące do wybierania rekordów w źródle danych.
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)
TableMappings	Pobiera kolekcję, która udostępnia podstawowe mapowanie między tabelą źródłową DataTablea . (Odziedziczone po DataAdapter)
UpdateBatchSize	Pobiera lub ustawia wartość, która włącza lub wyłącza obsługę przetwarzania wsadowego i określa liczbę poleceń, które mogą być wykonywane w partii.
UpdateCommand	Pobiera lub ustawia polecenie służące do aktualizowania rekordów w źródle danych.

Metody

AddToBatch(IDbCommand)	Dodaje element IDbCommand do bieżącej partii.
ClearBatch()	Usuwa wszystkie IDbCommand obiekty z partii.
CloneInternals()	Przestarzałe. Tworzy kopię tego wystąpienia klasy DataAdapter. (Odziedziczone po DataAdapter)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicjuje nowe wystąpienie klasy RowUpdatedEventArgs.
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicjuje nowe wystąpienie klasy RowUpdatingEventArgs.
CreateTableMappings()	Tworzy nowy adres DataTableMappingCollection. (Odziedziczone po DataAdapter)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DbDataAdapter i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExecuteBatch()	Wykonuje bieżącą partię.
Fill(DataSet)	Dodaje lub odświeża wiersze w obiekcie DataSet.
Fill(DataSet, Int32, Int32, String)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable .
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie , aby były zgodne z tymi w źródle danych przy użyciu DataSet nazw tabel źródłowych i źródłowych, ciągów poleceń i zachowania polecenia.
Fill(DataSet, String)	Dodaje lub odświeża wiersze w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable .
Fill(DataSet, String, IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable . (Odziedziczone po DataAdapter)
Fill(DataTable)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie w celu dopasowania ich do wierszy w źródle danych przy użyciu DataTable nazwy .
Fill(DataTable, IDataReader)	Dodaje lub odświeża wiersze w DataTable obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataTable nazwy i określonej wartości IDataReader. (Odziedziczone po DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w DataTable obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu określonych DataTableelementów i IDbCommandCommandBehavior.
Fill(DataTable[], IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w kolekcji DataTable obiektów w celu dopasowania ich do wierszy w źródle danych. (Odziedziczone po DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable .
Fill(Int32, Int32, DataTable[])	Dodaje lub odświeża wiersze w co najmniej jednym DataTable obiekcie w celu dopasowania ich do tych w źródle danych, począwszy od określonego rekordu i pobierania do określonej maksymalnej liczby rekordów.
FillSchema(DataSet, SchemaType)	DataTable Dodaje nazwę "Tabela" do określonego DataSet i konfiguruje schemat w taki sposób, aby był zgodny z tym w źródle danych na podstawie określonego SchemaTypeelementu .
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	DataTable Dodaje element do określonego DataSet elementu i konfiguruje schemat tak, aby był zgodny z tym w źródle danych na podstawie określonego SchemaTypeelementu .
FillSchema(DataSet, SchemaType, String)	DataTable Dodaje element do określonego DataSet elementu i konfiguruje schemat tak, aby był zgodny z tym w źródle danych na podstawie określonych SchemaType wartości i DataTable.
FillSchema(DataSet, SchemaType, String, IDataReader)	Dodaje element DataTable do określonego DataSetelementu . (Odziedziczone po DataAdapter)
FillSchema(DataTable, SchemaType)	Konfiguruje schemat określonego DataTable elementu na podstawie określonego SchemaTypeelementu .
FillSchema(DataTable, SchemaType, IDataReader)	Dodaje element DataTable do określonego DataSetelementu . (Odziedziczone po DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Konfiguruje schemat określonego DataTable elementu na podstawie określonego SchemaType, ciągu polecenia i CommandBehavior wartości.
GetBatchedParameter(Int32, Int32)	Zwraca element IDataParameter z jednego z poleceń w bieżącej partii.
GetBatchedRecordsAffected(Int32, Int32, Exception)	Zwraca informacje o pojedynczej próbie aktualizacji w ramach większej aktualizacji wsadowej.
GetFillParameters()	Pobiera parametry ustawione przez użytkownika podczas wykonywania instrukcji SQL SELECT.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
HasTableMappings()	Wskazuje, czy DataTableMappingCollection element został utworzony. (Odziedziczone po DataAdapter)
InitializeBatching()	Inicjuje przetwarzanie wsadowe dla klasy DbDataAdapter.
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Wywoływane w przypadku wystąpienia błędu podczas operacji Fill. (Odziedziczone po DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Zgłasza zdarzenie dostawcy danych platformy RowUpdated .NET.
OnRowUpdating(RowUpdatingEventArgs)	Zgłasza zdarzenie dostawcy danych platformy RowUpdating .NET.
ResetFillLoadOption()	Resetuje FillLoadOption do stanu domyślnego i powoduje Fill(DataSet) honorowanie AcceptChangesDuringFill. (Odziedziczone po DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Określa, czy AcceptChangesDuringFill właściwość ma być utrwalone. (Odziedziczone po DataAdapter)
ShouldSerializeFillLoadOption()	Określa, czy FillLoadOption właściwość ma być utrwalone. (Odziedziczone po DataAdapter)
ShouldSerializeTableMappings()	Określa, czy istnieje co najmniej jeden DataTableMapping obiekt i czy powinny być utrwalane. (Odziedziczone po DataAdapter)
TerminateBatching()	Kończy przetwarzanie wsadowe dla .DbDataAdapter
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
Update(DataRow[])	Aktualizacje 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 DataSetobiekcie .
Update(DataRow[], DataTableMapping)	Aktualizacje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego DataRow wiersza w określonej tablicy obiektów.
Update(DataSet)	Aktualizacje 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 DataSetwierszu .
Update(DataSet, String)	Aktualizacje wartości w bazie danych, wykonując odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza w DataSet obiekcie o określonej DataTable nazwie.
Update(DataTable)	Aktualizacje 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 DataTablewierszu .

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
FillError	Zwracany, gdy wystąpił błąd podczas operacji wypełniania. (Odziedziczone po DataAdapter)

Jawne implementacje interfejsu

ICloneable.Clone()	Tworzy nowy obiekt, który jest kopią bieżącego wystąpienia.
IDataAdapter.TableMappings	Pobiera kolekcję wskazującą sposób mapowania tabeli źródłowej na tabelę zestawu danych. (Odziedziczone po DataAdapter)
IDbDataAdapter.DeleteCommand	Pobiera lub ustawia instrukcję SQL na potrzeby usuwania rekordów z zestawu danych.
IDbDataAdapter.InsertCommand	Pobiera lub ustawia instrukcję SQL używaną do wstawiania nowych rekordów do źródła danych.
IDbDataAdapter.SelectCommand	Pobiera lub ustawia instrukcję SQL używaną do wybierania rekordów w źródle danych.
IDbDataAdapter.UpdateCommand	Pobiera lub ustawia instrukcję SQL używaną do aktualizowania rekordów w źródle danych.

Dotyczy

Zobacz też

• DbProviderFactories (ADO.NET)
• Omówienie ADO.NET