DataAdapter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.Common

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

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.

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

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

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

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

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

type DataAdapter = class
    inherit Component
    interface IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

Public MustInherit 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 DataSet źródłem danych a i służącym do pobierania i zapisywania danych. Zapewnia DataAdapter ten mostek przez mapowanie Fill, które zmienia dane w obiekcie tak DataSet , aby pasować do danych w źródle danych i Update, które zmieniają dane w źródle danych tak, aby pasły do danych w elemecie DataSet.

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

Po utworzeniu DataAdapter wystąpienia właściwości odczytu/zapisu są ustawione 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ąDataRow, czy AcceptChanges() jest wywoływana po dodaniu jej do DataTable dowolnego z 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, gdy podczas aktualizacji wiersza wystąpi błąd.
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 wartość LoadOption określającą sposób wypełnienia DataTable adaptera z elementu DbDataReader.
MissingMappingAction	Określa akcję do wykonania, gdy dane przychodzące nie mają pasującej 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 ISite element .Component (Odziedziczone po Component)
TableMappings	Pobiera kolekcję, która udostępnia podstawowe mapowanie między tabelą źródłową DataTablea .

Metody

CloneInternals()	Nieaktualne. Nieaktualne. Nieaktualne. Nieaktualne. Tworzy kopię tego wystąpienia programu 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 obiekcie DataSet , aby dopasować je do tych w źródle danych.
Fill(DataSet, String, IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu nazw DataSet i .DataTable
Fill(DataTable, IDataReader)	Dodaje lub odświeża wiersze w obiekcie, DataTable aby były zgodne z tymi 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 tych w źródle danych.
FillSchema(DataSet, SchemaType)	Dodaje element DataTable do określonego DataSet i konfiguruje schemat, 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()	Nieaktualne. 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()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
HasTableMappings()	Wskazuje, czy DataTableMappingCollection element został utworzony.
InitializeLifetimeService()	Nieaktualne. 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 DataSet DataTable 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.

Dotyczy

Zobacz też

Omówienie ADO.NET