DbDataAdapter Třída

Definice

Obor názvů:

System.Data.Common

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

DbDataAdapter.cs

Pomůcek IDbDataAdapter provádění rozhraní. Dědiče DbDataAdapter implementace sady funkcí pro zajištění silného psaní, ale dědí většinu funkcí potřebných k úplné implementaci dataAdapteru.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter

public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter

type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter

Dědičnost

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

Odvozené

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Poznámky

Třída DbDataAdapter dědí z DataAdapter třídy a implementuje IDbDataAdapter rozhraní. Pomáhá třídě implementovat DataAdapter navržený pro použití s relační databází.

Aplikace nevytvoří přímo instanci DbDataAdapter třídy, ale vytvoří instanci třídy, která z ní dědí.

Třídy, které dědí, musí implementovat zděděné DbDataAdapter členy a obvykle definují další členy pro přidání funkcí specifických pro zprostředkovatele. Třída například DbDataAdapter definuje vlastnost a DbDataAdapter třída definuje osm přetížení FillSelectCommand metody. Třída zase OleDbDataAdapter dědí metodu Fill a také definuje dvě další přetížení Fill , které přebírají objekt ADO Recordset jako parametr.

Poznámky pro implementátory

Při dědění z DbDataAdapter třídy doporučujeme implementovat následující konstruktory:

Položka	Popis
*Prv*DataAdapter()	Inicializuje novou instanci *Prv*DataAdapter třídy.
*Prv*DataAdapter(*Prv*Command *selectCommand*)	Inicializuje novou instanci *Prv*DataAdapter třídy pomocí zadaného příkazu SQL SELECT.
*Prv*DataAdapter(řetězec *selectCommandText*, řetězec *selectConnectionString*)	Inicializuje novou instanci třídy *Prv*DataAdapter příkazem SQL SELECT a připojovacím řetězcem.
*Prv*DataAdapter(řetězec *selectCommandText*, *Prv*Connection *selectConnection*)	Inicializuje novou instanci třídy *Prv*DataAdapter příkazem SQL SELECT a objektem *Prv*Connection.

Chcete-li zvýšit konzistenci mezi zprostředkovateli dat rozhraní .NET Framework, měli byste pojmenovat zděděnou třídu ve formátu PrvDataAdapter, kde Prv je jednotnou předponou přidělenou všem třídám v konkrétním oboru názvů zprostředkovatele dat rozhraní .NET Framework. Například "Sql" je předpona SqlDataAdapter třídy v oboru názvů System.Data.SqlClient .

Konstruktory

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

Pole

Name	Description
DefaultSourceTableName	Výchozí název používaný objektem DataAdapter pro mapování tabulek.

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 . (Zděděno od DataAdapter)
AcceptChangesDuringUpdate	Získá nebo nastaví, zda AcceptChanges() je volána během Update(DataSet). (Zděděno od DataAdapter)
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. (Zděděno od DataAdapter)
DeleteCommand	Získá nebo nastaví příkaz pro odstranění záznamů z datové sady.
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)
FillCommandBehavior	Získá nebo nastaví chování příkazu použitého k vyplnění datového adaptéru.
FillLoadOption	Získá nebo nastaví LoadOption , který určuje, jak adaptér vyplní DataTable z DbDataReader. (Zděděno od DataAdapter)
InsertCommand	Získá nebo nastaví příkaz použitý k vložení nových záznamů do zdroje dat.
MissingMappingAction	Určuje akci, která se má provést, když příchozí data nemají odpovídající tabulku nebo sloupec. (Zděděno od DataAdapter)
MissingSchemaAction	Určuje akci, která se má provést, když existující DataSet schéma neodpovídá příchozím datům. (Zděděno od DataAdapter)
ReturnProviderSpecificTypes	Získá nebo nastaví, zda Fill metoda má vrátit hodnoty specifické pro zprostředkovatele nebo běžné hodnoty kompatibilní se specifikací CLS. (Zděděno od DataAdapter)
SelectCommand	Získá nebo nastaví příkaz použitý k výběru záznamů ve zdroji dat.
Site	Získá nebo nastaví ISite .Component (Zděděno od Component)
TableMappings	Získá kolekci, která poskytuje primární mapování mezi zdrojovou tabulkou a .DataTable (Zděděno od DataAdapter)
UpdateBatchSize	Získá nebo nastaví hodnotu, která povolí nebo zakáže podporu dávkového zpracování a určuje počet příkazů, které lze spustit v dávce.
UpdateCommand	Získá nebo nastaví příkaz použitý k aktualizaci záznamů ve zdroji dat.

Metody

Name	Description
AddToBatch(IDbCommand)	IDbCommand Přidá do aktuální dávky.
ClearBatch()	Odebere všechny IDbCommand objekty z dávky.
CloneInternals()	Zastaralé. Vytvoří kopii této instance DataAdapter. (Zděděno od DataAdapter)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializuje novou instanci RowUpdatedEventArgs třídy.
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializuje novou instanci RowUpdatingEventArgs třídy.
CreateTableMappings()	Vytvoří novou DataTableMappingCollection. (Zděděno od DataAdapter)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané DbDataAdapter a volitelně uvolní spravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExecuteBatch()	Spustí aktuální dávku.
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Přidá nebo aktualizuje řádky v zadané oblasti tak DataSet , aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvů a názvů zdrojových tabulek, příkazového řetězce a chování příkazů.
Fill(DataSet, Int32, Int32, String)	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, 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ů. (Zděděno od DataAdapter)
Fill(DataSet, String)	Přidá nebo aktualizuje řádky 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 v sadě DataSet.
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. (Zděděno od DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Přidá nebo aktualizuje řádky takDataTable, aby odpovídaly řádkům ve zdroji dat pomocí zadaného IDbCommandDataTablea CommandBehavior.
Fill(DataTable)	Přidá nebo aktualizuje řádky v zadané oblasti tak DataSet , aby odpovídaly řádkům ve zdroji dat pomocí DataTable názvu.
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. (Zděděno od DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	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(Int32, Int32, DataTable[])	Přidá nebo aktualizuje řádky v jednom nebo více DataTable objektech tak, aby odpovídaly řádkům ve zdroji dat počínaje zadaným záznamem a načítáním až do zadaného maximálního počtu záznamů.
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	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(DataSet, SchemaType, String, IDataReader)	DataTable Přidá do zadaného DataSetparametru . (Zděděno od DataAdapter)
FillSchema(DataSet, SchemaType, String)	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 a DataTable.
FillSchema(DataSet, SchemaType)	Přidá do zadaného pole pojmenovanou DataTable tabulku a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaného SchemaType.DataSet
FillSchema(DataTable, SchemaType, IDataReader)	DataTable Přidá do zadaného DataSetparametru . (Zděděno od DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Nakonfiguruje schéma zadaného DataTable na základě zadaného SchemaTypeřetězce příkazu a CommandBehavior hodnot.
FillSchema(DataTable, SchemaType)	Konfiguruje schéma zadaného DataTable na základě zadaného SchemaType.
GetBatchedParameter(Int32, Int32)	IDataParameter Vrátí z jednoho z příkazů v aktuální dávce.
GetBatchedRecordsAffected(Int32, Int32, Exception)	Vrátí informace o jednotlivých pokusech o aktualizaci v rámci větší dávkové aktualizace.
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. (Zděděno od DataAdapter)
InitializeBatching()	Inicializuje dávkování pro DbDataAdapter.
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. (Zděděno od DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	RowUpdated Vyvolá událost zprostředkovatele dat .NET.
OnRowUpdating(RowUpdatingEventArgs)	RowUpdating Vyvolá událost zprostředkovatele dat .NET.
ResetFillLoadOption()	FillLoadOption Obnoví výchozí stav a způsobíFill(DataSet), že bude respektovat AcceptChangesDuringFill. (Zděděno od DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Určuje, zda AcceptChangesDuringFill má být vlastnost zachována. (Zděděno od DataAdapter)
ShouldSerializeFillLoadOption()	Určuje, zda FillLoadOption má být vlastnost zachována. (Zděděno od DataAdapter)
ShouldSerializeTableMappings()	Určuje, zda jeden nebo více DataTableMapping objektů existuje a mají být zachovány. (Zděděno od DataAdapter)
TerminateBatching()	Končí dávkování pro DbDataAdapter.
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(DataRow[], DataTableMapping)	Aktualizuje hodnoty v databázi spuštěním příslušných příkazů INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v zadaném poli DataRow objektů.
Update(DataRow[])	Aktualizuje hodnoty v databázi spuštěním příslušných příkazů INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v zadaném poli v DataSetpoli .
Update(DataSet, String)	Aktualizuje hodnoty v databázi spuštěním příslušných příkazů INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v DataSet zadaném DataTable názvu.
Update(DataSet)	Aktualizuje hodnoty v databázi spuštěním příslušných příkazů INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v zadaném DataSetřádku .
Update(DataTable)	Aktualizuje hodnoty v databázi spuštěním příslušných příkazů INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v zadaném DataTableřádku .

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ě. (Zděděno od DataAdapter)

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Vytvoří nový objekt, který je kopií aktuální instance.
IDataAdapter.TableMappings	Získá kolekci, která označuje, jak je zdrojová tabulka mapována na tabulku datové sady. (Zděděno od DataAdapter)
IDbDataAdapter.DeleteCommand	Získá nebo nastaví příkaz SQL pro odstranění záznamů z datové sady.
IDbDataAdapter.InsertCommand	Získá nebo nastaví příkaz SQL použitý k vložení nových záznamů do zdroje dat.
IDbDataAdapter.SelectCommand	Získá nebo nastaví příkaz SQL použitý k výběru záznamů ve zdroji dat.
IDbDataAdapter.UpdateCommand	Získá nebo nastaví příkaz SQL sloužící k aktualizaci záznamů ve zdroji dat.

Viz také

• DbProviderFactories (ADO.NET)
• Přehled ADO.NET