DataAdapter Třída

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Zdroj:

DataAdapter.cs

Představuje sadu příkazů SQL a připojení k databázi, které se používají k vyplnění DataSet a aktualizaci zdroje dat.

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

Dědičnost

Object

MarshalByRefObject

Component

DataAdapter

Odvozené

System.Data.Common.DbDataAdapter

Implementuje

IDataAdapter

Poznámky

Slouží DataAdapter jako most mezi DataSet a zdrojem dat pro načítání a ukládání dat. Nástroj DataAdapter poskytuje tento most mapováním Fill, které změní data v souboru DataSet tak, aby odpovídala datům ve zdroji dat, a Update, které změní data ve zdroji dat tak, aby odpovídala datům v DataSet.

Pokud se připojujete k databázi SQL Server, můžete zvýšit celkový výkon pomocí SqlDataAdapter funkce spolu s přidruženými SqlCommand objekty a SqlConnection objekty. U zdrojů dat podporovaných službou OLE DB použijte DataAdapter s přidruženými OleDbCommand objekty a OleDbConnection objekty. U zdrojů dat podporovaných rozhraním ODBC použijte DataAdapter s přidruženými OdbcCommand objekty a OdbcConnection objekty. Pro databáze Oracle použijte DataAdapter s přidruženými OracleCommand objekty a OracleConnection objekty.

Při vytvoření instance objektu DataAdapter jsou vlastnosti pro čtení a zápis nastaveny na počáteční hodnoty. Seznam těchto hodnot najdete v konstruktoru DataAdapter .

Konstruktory

DataAdapter()	Inicializuje novou instanci DataAdapter třídy.
DataAdapter(DataAdapter)	Inicializuje novou instanci DataAdapter třídy z existujícího objektu stejného typu.

Vlastnosti

AcceptChangesDuringFill	Získá nebo nastaví hodnotu označující, zda AcceptChanges() je volána DataRow po přidání do DataTable některé z operací Fill .
AcceptChangesDuringUpdate	Získá nebo nastaví, zda AcceptChanges() je volána během Update(DataSet).
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
ContinueUpdateOnError	Získá nebo nastaví hodnotu, která určuje, zda se má vygenerovat výjimka při výskytu chyby během aktualizace řádku.
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
FillLoadOption	Získá nebo nastaví, LoadOption který určuje, jak adaptér vyplní DataTable z DbDataReader.
MissingMappingAction	Určuje akci, která se má provést, když příchozí data nemají odpovídající tabulku nebo sloupec.
MissingSchemaAction	Určuje akci, která se má provést, když stávající DataSet schéma neodpovídá příchozím datům.
ReturnProviderSpecificTypes	Získá nebo nastaví, zda Fill metoda má vrátit hodnoty specifické pro zprostředkovatele nebo běžné hodnoty cls kompatibilní hodnoty.
Site	Získá nebo nastaví ISite hodnotu Component. (Zděděno od Component)
TableMappings	Získá kolekci, která poskytuje primární mapování mezi zdrojovou tabulkou DataTablea .

Metody

CloneInternals()	Zastaralé. Vytvoří kopii této instance objektu DataAdapter.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
CreateTableMappings()	Vytvoří nový objekt DataTableMappingCollection.
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané DataAdapter nástrojem a volitelně uvolní spravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Fill(DataSet)	Přidá nebo aktualizuje řádky v objektu tak, DataSet aby odpovídaly řádkům ve zdroji dat.
Fill(DataSet, String, IDataReader, Int32, Int32)	Přidá nebo aktualizuje řádky v zadané oblasti v objektu DataSet tak, aby odpovídaly řádkům ve zdroji DataSet dat pomocí názvů a DataTable .
Fill(DataTable, IDataReader)	Přidá nebo aktualizuje řádky v objektu DataTable tak, aby odpovídaly řádkům ve zdroji dat pomocí DataTable názvu a zadaného IDataReaderobjektu .
Fill(DataTable[], IDataReader, Int32, Int32)	Přidá nebo aktualizuje řádky v zadané oblasti v kolekci DataTable objektů tak, aby odpovídaly řádkům ve zdroji dat.
FillSchema(DataSet, SchemaType)	DataTable Přidá k zadanému DataSet a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaného SchemaType.
FillSchema(DataSet, SchemaType, String, IDataReader)	Přidá do zadaného DataSetparametru DataTable .
FillSchema(DataTable, SchemaType, IDataReader)	Přidá do zadaného DataSetparametru DataTable .
GetFillParameters()	Získá parametry nastavené uživatelem při spuštění příkazu SQL SELECT.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
HasTableMappings()	Označuje, jestli DataTableMappingCollection byl vytvořen objekt.
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Vyvolá se při výskytu chyby během Fill.
ResetFillLoadOption()	FillLoadOption Obnoví výchozí stav a způsobíFill(DataSet), že bude respektovat AcceptChangesDuringFill.
ShouldSerializeAcceptChangesDuringFill()	Určuje, zda má AcceptChangesDuringFill být vlastnost trvalá.
ShouldSerializeFillLoadOption()	Určuje, zda má FillLoadOption být vlastnost trvalá.
ShouldSerializeTableMappings()	Určuje, zda existuje jeden nebo více DataTableMapping objektů a měly by být trvalé.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)
Update(DataSet)	Volá příslušné příkazy INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v zadaném DataSet z pojmenovaného DataTable "Table".

Událost

Disposed	Nastane, když je komponenta odstraněna voláním Dispose() metody. (Zděděno od Component)
FillError	Vrátí se, když během operace vyplňování dojde k chybě.

Explicitní implementace rozhraní

IDataAdapter.TableMappings

Získá kolekci, která označuje, jak je zdrojová tabulka mapována na tabulku datové sady.

Viz také

• Přehled ADO.NET