DataAdapter Třída

Definice

Obor názvů:

System.Data.Common

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

DataAdapter.cs

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

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

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
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

Atributy

DynamicallyAccessedMembersAttribute

Implementuje

IDataAdapter

Poznámky

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

Pokud se připojujete k databázi SQL Server, můžete celkový výkon zvýšit pomocí SqlDataAdapter spolu s přidruženými objekty SqlCommand a SqlConnection. U zdrojů dat podporovaných ole DB použijte DataAdapter s přidruženými OleDbCommand a OleDbConnection objekty. U zdrojů dat podporovaných rozhraním ODBC použijte DataAdapter s přidruženými OdbcCommand 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 DataAdapter jsou vlastnosti pro čtení a zápis nastaveny na počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru DataAdapter .

Konstruktory

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

Vlastnosti

Name	Description
AcceptChangesDuringFill	Získá nebo nastaví hodnotu označující, zda AcceptChanges() je volá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 během Update(DataSet).
CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá ten 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 Component je aktuálně v režimu návrhu. (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ž existují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 kompatibilní se specifikací CLS.
Site	Získá nebo nastaví ISite objektu Component. (Zděděno od Component)
TableMappings	Získá kolekci, která poskytuje primární mapování mezi zdrojovou tabulkou a .DataTable

Metody

Name	Description
CloneInternals()	Zastaralé. Vytvoří kopii této instance DataAdapter.
CreateTableMappings()	Vytvoří novou 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 a volitelně uvolní spravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Fill(DataSet, String, IDataReader, Int32, Int32)	Přidá nebo aktualizuje řádky v zadané oblasti tak DataSet , aby odpovídaly řádkům ve zdroji dat pomocí názvů DataSet a DataTable názvů.
Fill(DataSet)	Přidá nebo aktualizuje řádky ve DataSet zdroji dat tak, aby odpovídaly řádkům ve zdroji dat.
Fill(DataTable, IDataReader)	Přidá nebo aktualizuje řádky tak DataTable , aby odpovídaly řádkům ve zdroji dat pomocí DataTable názvu a zadaného IDataReader.
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, String, IDataReader)	DataTable Přidá do zadaného DataSetparametru .
FillSchema(DataSet, SchemaType)	DataTable Přidá do zadaného DataSet a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaného SchemaType.
FillSchema(DataTable, SchemaType, IDataReader)	DataTable Přidá do zadaného DataSetparametru .
GetFillParameters()	Získá parametry nastavené uživatelem při provádění příkazu SQL SELECT.
GetHashCode()	Slouží jako výchozí funkce hash. (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 jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
HasTableMappings()	Určuje, zda DataTableMappingCollection byl vytvořen.
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Vyvoláno, 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 jeden nebo více DataTableMapping objektů existuje a mají být zachovány.
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 textu z pojmenované DataTable tabulky.

Událost

Name	Description
Disposed	Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)
FillError	Vráceno, když během operace vyplnění dojde k chybě.

Explicitní implementace rozhraní

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

Viz také

• Přehled ADO.NET