DataAdapter Klasa

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DataAdapter.cs

Reprezentuje zestaw poleceń SQL i połączenie bazy danych, które są używane do wypełniania DataSet i aktualizowania źródła danych.

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter

public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

type DataAdapter = class
    inherit Component
    interface IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

Dziedziczenie

Object

MarshalByRefObject

Component

DataAdapter

Pochodne

System.Data.Common.DbDataAdapter

Implementuje

IDataAdapter

Uwagi

Element DataAdapter służy jako most między źródłem danych a DataSet i służącym do pobierania i zapisywania danych. Zapewnia DataAdapter ten mostek przez mapowanie Fill, które zmienia dane w DataSet obiekcie w celu dopasowania ich do danych w źródle danych i Update, co zmienia dane w źródle danych w celu dopasowania ich do danych w elemecie DataSet.

Jeśli łączysz się z bazą danych SQL Server, możesz zwiększyć ogólną wydajność, używając SqlDataAdapter obiektu wraz ze skojarzonymi SqlCommand obiektami i SqlConnection . W przypadku źródeł danych obsługiwanych przez ole DB należy użyć obiektu DataAdapter ze skojarzonymi obiektami OleDbCommand i OleDbConnection . W przypadku źródeł danych obsługiwanych przez funkcję ODBC należy użyć obiektu DataAdapter ze skojarzonymi obiektami OdbcCommand i OdbcConnection . W przypadku baz danych Oracle użyj obiektu DataAdapter ze skojarzonymi obiektami OracleCommand i OracleConnection .

Po utworzeniu DataAdapter wystąpienia obiektu właściwości odczytu/zapisu są ustawiane na wartości początkowe. Aby uzyskać listę tych wartości, zobacz DataAdapter konstruktor.

Konstruktory

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

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 .
AcceptChangesDuringUpdate	Pobiera lub ustawia, czy AcceptChanges() jest wywoływany podczas .Update(DataSet)
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.
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)
FillLoadOption	Pobiera lub ustawia LoadOption element określający sposób wypełniania DataTable obiektu przez adapter z obiektu DbDataReader.
MissingMappingAction	Określa akcję, która ma być wykonywana, gdy dane przychodzące nie mają zgodnej tabeli ani kolumny.
MissingSchemaAction	Określa akcję do wykonania, gdy istniejący DataSet schemat nie jest zgodny z danymi przychodzącymi.
ReturnProviderSpecificTypes	Pobiera lub ustawia, czy Fill metoda powinna zwracać wartości specyficzne dla dostawcy, czy typowe wartości zgodne ze specyfikacją CLS.
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 .

Metody

CloneInternals()	Przestarzałe. Tworzy kopię tego wystąpienia klasy 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)
CreateTableMappings()	Tworzy nowy adres DataTableMappingCollection.
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DataAdapter i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Fill(DataSet)	Dodaje lub odświeża wiersze w DataSet obiekcie w celu dopasowania ich do wierszy w źródle danych.
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 .
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.
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.
FillSchema(DataSet, SchemaType)	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, IDataReader)	Dodaje element DataTable do określonego DataSetelementu .
FillSchema(DataTable, SchemaType, IDataReader)	Dodaje element DataTable do określonego DataSetelementu .
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 wartość bieżącego wystąpienia. (Odziedziczone po Object)
HasTableMappings()	Wskazuje, czy DataTableMappingCollection element został utworzony.
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.
ResetFillLoadOption()	Resetuje FillLoadOption do stanu domyślnego i powoduje Fill(DataSet) honorowanie AcceptChangesDuringFill.
ShouldSerializeAcceptChangesDuringFill()	Określa, czy AcceptChangesDuringFill właściwość ma być utrwalone.
ShouldSerializeFillLoadOption()	Określa, czy FillLoadOption właściwość ma być utrwalone.
ShouldSerializeTableMappings()	Określa, czy istnieje co najmniej jeden DataTableMapping obiekt i czy powinny być utrwalane.
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
Update(DataSet)	Wywołuje odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego wiersza określonego DataSetDataTable z nazwy "Tabela".

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.

Jawne implementacje interfejsu

IDataAdapter.TableMappings

Pobiera kolekcję wskazującą sposób mapowania tabeli źródłowej na tabelę zestawu danych.

Zobacz też

• Omówienie ADO.NET