DbDataAdapter Klasa
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.
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.
public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable
type DbDataAdapter = class
inherit DataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
type DbDataAdapter = class
inherit DataAdapter
interface ICloneable
type DbDataAdapter = class
inherit DataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable
- Dziedziczenie
- Pochodne
- Implementuje
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 |
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 |
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.
Przestarzałe.
Przestarzałe.
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 DataSetnazw , DataTablei IDataReader . |
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 obiekcie DataTable w celu dopasowania ich do tych w źródle danych przy użyciu określonych DataTable nazw i IDataReader . |
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) |
FillError Zgłasza zdarzenie. |
OnFillError(FillErrorEventArgs) |
Wywoływane w przypadku wystąpienia błędu podczas operacji |
OnRowUpdated(RowUpdatedEventArgs) |
Zgłasza zdarzenie dostawcy danych platformy |
OnRowUpdating(RowUpdatingEventArgs) |
Zgłasza zdarzenie dostawcy danych platformy |
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. |
FillError |
Zwracany, gdy wystąpił błąd podczas operacji wypełniania. (Odziedziczone po DataAdapter) |
Jawne implementacje interfejsu
ICloneable.Clone() |
Przestarzałe.
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. |