DataAdapter Třída

Reference

Definice

Obor názvů:: System.Data.Common

Sestavení:: System.Data.Common.dll

Sestavení:: System.Data.dll

Sestavení:: netstandard.dll

Source:: DataAdapter.cs

Source:: DataAdapter.cs

Source:: DataAdapter.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

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. Poskytuje DataAdapter 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 použitím objektu SqlDataAdapter spolu s přidruženými SqlCommand objekty a SqlConnection . V případě zdrojů dat podporovaných rozhraním OLE DB použijte DataAdapter s přidruženými OleDbCommand objekty a OleDbConnection . U zdrojů dat podporovaných rozhraním ODBC použijte DataAdapter s přidruženými OdbcCommand objekty a OdbcConnection . V případě databází Oracle použijte DataAdapter s přidruženými OracleCommand objekty a OracleConnection .

Při vytvoření instance objektu DataAdapter jsou vlastnosti pro čtení a zápis nastaveny na počáteční hodnoty. Seznam těchto hodnot naleznete 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 na po DataRow přidání do DataTable během některé z operací Fill .
AcceptChangesDuringUpdate	Získá nebo nastaví, zda AcceptChanges() je volána Update(DataSet)během .
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, pokud existující DataSet schéma neodpovídá příchozím datům.
ReturnProviderSpecificTypes	Získá nebo nastaví, zda `Fill` metoda by měla vrátit hodnoty specifické pro zprostředkovatele nebo běžné hodnoty kompatibilní s CLS.
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
TableMappings	Získá kolekci, která poskytuje primární mapování mezi zdrojovou tabulkou DataTablea .

Metody

CloneInternals()	Zastaralé. Zastaralé. Zastaralé. Zastaralé. Vytvoří kopii této instance .DataAdapter
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící 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é nástrojem DataAdapter 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 aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvů a DataTable .
Fill(DataTable, IDataReader)	Přidá nebo aktualizuje řádky v objektu tak DataTable , 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 aktuální životnost objektu služby, 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 .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
HasTableMappings()	Označuje, jestli DataTableMappingCollection byl vytvořen objekt .
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, 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, když dojde k chybě během `Fill`.
ResetFillLoadOption()	FillLoadOption Obnoví výchozí stav a způsobíFill(DataSet), že bude respektovat AcceptChangesDuringFill.
ShouldSerializeAcceptChangesDuringFill()	Určuje, zda AcceptChangesDuringFill má být vlastnost zachována.
ShouldSerializeFillLoadOption()	Určuje, zda FillLoadOption má být vlastnost zachována.
ShouldSerializeTableMappings()	Určuje, zda existuje jeden nebo více DataTableMapping objektů a měly by být zachovány.
ToString()	String Vrátí hodnotu obsahující název , Componentpokud 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 "Tabulka".

Událost

Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)
FillError	Vrátí se, když během operace vyplně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.

Platí pro

Viz také

Přehled ADO.NET