DbDataAdapter Klasa

Definicja

Przestrzeń nazw:

System.Data.Common

Zestawy:

netstandard.dll, System.Data.Common.dll

Źródło:

DbDataAdapter.cs

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

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

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

type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, 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. Ułatwia to klasy implementowanie elementu DataAdapter przeznaczonego 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.

Notatki dotyczące implementowania

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

Przedmiot	Opis
*Prv*DataAdapter()	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter.
*Prv*DataAdapter(*Prv*Polecenie *selectCommand*)	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter przy użyciu określonej instrukcji SQL SELECT.
*Prv*DataAdapter(ciąg *selectCommandText*, ciąg *selectConnectionString*)	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter za pomocą instrukcji SQL SELECT i parametrów połączenia.
*Prv*DataAdapter(ciąg *selectCommandText*, *Prv*Connection *selectConnection*)	Inicjuje nowe wystąpienie klasy *Prv*DataAdapter za pomocą instrukcji SQL SELECT i obiektu *Prv*Connection.

Aby promować spójność wśród dostawców danych programu .NET Framework, należy nazwać klasę dziedziczącą w postaci PrvDataAdapter, gdzie Prv to jednolity prefiks nadany wszystkim klasom w określonej przestrzeni nazw dostawcy danych programu .NET Framework. Na przykład "Sql" jest prefiksem SqlDataAdapter klasy w przestrzeni nazw System.Data.SqlClient .

Konstruktory

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

Pola

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

Właściwości

Nazwa	Opis
AcceptChangesDuringFill	Pobiera lub ustawia wartość wskazującą, czy AcceptChanges() jest wywoływana na końcu 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 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 elementu Component. (Odziedziczone po Component)
FillCommandBehavior	Pobiera lub ustawia zachowanie polecenia użytego do wypełnienia karty danych.
FillLoadOption	Pobiera lub ustawia LoadOption element, który określa, jak karta wypełnia DataTable element z .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ą pasującej tabeli ani kolumny. (Odziedziczone po DataAdapter)
MissingSchemaAction	Określa akcję, która ma być wykonywana, 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 używane 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 można wykonać w partii.
UpdateCommand	Pobiera lub ustawia polecenie używane do aktualizowania rekordów w źródle danych.

Metody

Nazwa	Opis
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)
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 DataTableMappingCollectionelement . (Odziedziczone po DataAdapter)
Dispose()	Zwalnia wszystkie zasoby używane przez program Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez DbDataAdapter program i opcjonalnie zwalnia zarządzane zasoby.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
ExecuteBatch()	Wykonuje bieżącą partię.
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie , aby dopasować je w źródle danych przy użyciu DataSet nazw tabel źródłowych i, ciągu polecenia i zachowania polecenia.
Fill(DataSet, Int32, Int32, String)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie , aby dopasować je 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 , aby dopasować je w źródle danych przy użyciu DataSet nazw i DataTable . (Odziedziczone po DataAdapter)
Fill(DataSet, String)	Dodaje lub odświeża wiersze w obiekcie DataSet , aby dopasować je w źródle danych przy użyciu DataSet nazw i DataTable .
Fill(DataSet)	Dodaje lub odświeża wiersze w pliku DataSet.
Fill(DataTable, IDataReader)	Dodaje lub odświeża wiersze w obiekcie DataTable , aby pasować 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 źródle danych, aby były zgodne z tymi w źródle danych przy użyciu określonych DataTableelementów i IDbCommandCommandBehavior.
Fill(DataTable)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie , aby pasować do wierszy w źródle danych przy użyciu DataTable nazwy .
Fill(DataTable[], IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w kolekcji DataTable obiektów, aby były zgodne z wierszami 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 , aby dopasować je 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, aby pasowały do tych w źródle danych rozpoczynającym się od określonego rekordu i pobierając maksymalną liczbę rekordów.
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Dodaje element DataTable 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, IDataReader)	Dodaje element DataTable do określonego DataSetelementu . (Odziedziczone po DataAdapter)
FillSchema(DataSet, SchemaType, String)	Dodaje element DataTable 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)	DataTable Dodaje do określonego DataSet elementu nazwę "Tabela" i konfiguruje schemat tak, aby był zgodny z tym w źródle danych 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ślony DataTable na podstawie określonego SchemaTypeciągu polecenia i CommandBehavior wartości.
FillSchema(DataTable, SchemaType)	Konfiguruje schemat określonego DataTable elementu na podstawie określonego SchemaTypeelementu .
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 reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
HasTableMappings()	Wskazuje, czy DataTableMappingCollection element został utworzony. (Odziedziczone po DataAdapter)
InitializeBatching()	Inicjuje przetwarzanie wsadowe dla elementu 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 Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Wywoływane, gdy wystąpi błąd podczas elementu Fill. (Odziedziczone po DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Wywołuje zdarzenie dostawcy danych platformy RowUpdated .NET.
OnRowUpdating(RowUpdatingEventArgs)	Wywołuje 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 jeden lub więcej DataTableMapping obiektów istnieje i czy powinny być utrwalane. (Odziedziczone po DataAdapter)
TerminateBatching()	Kończy przetwarzanie wsadowe dla elementu DbDataAdapter.
ToString()	Zwraca wartość zawierającą String nazwę Component, jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
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 DataRow wiersza w określonej tablicy obiektów.
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 DataSetobiekcie .
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 z DataSet określoną DataTable nazwą.
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 DataSetwierszu .
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 DataTablewierszu .

Zdarzenia

Nazwa	Opis
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

Nazwa	Opis
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ę zestawów 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.

Zobacz też

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