OleDbDataAdapter Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v9.0.0-rc.1.24431.7

Zdroj:

OleDbDataAdapter.cs

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

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

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

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Dědičnost

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Příklady

Následující příklad používá OleDbCommand, OleDbDataAdapter a OleDbConnection, k výběru záznamů ze zdroje dat Accessu a naplnění DataSet objektu vybranými řádky. Vyplněný DataSet se pak vrátí. Za tímto účelem se metodě předá inicializovaný DataSetřetězec , připojovací řetězec a řetězec dotazu, který je příkazem SQL SELECT.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Poznámky

Slouží OleDbDataAdapter jako most mezi DataSet zdrojem dat a pro načítání a ukládání dat. Poskytuje OleDbDataAdapter tento most pomocí Fill k načtení dat ze zdroje dat do DataSeta pomocí Update k odeslání změn provedených v zadní části DataSet do zdroje dat.

Když vyplní OleDbDataAdapterDataSet, vytvoří odpovídající tabulky a sloupce pro vrácená data, pokud ještě neexistují. Informace o primárním klíči však nejsou zahrnuty do implicitně vytvořeného schématu MissingSchemaAction , pokud není vlastnost nastavena na AddWithKeyhodnotu . Můžete také vytvořit OleDbDataAdapter schéma , včetně informací o primárním DataSetklíči, před jeho vyplněním dat pomocí FillSchema. Další informace najdete v tématu Přidání existujících omezení do datové sady.

Všimněte si, že někteří zprostředkovatelé OLE DB, včetně zprostředkovatele MSDataShape, nevrací základní tabulku nebo informace o primárním klíči. OleDbDataAdapter Proto nelze správně nastavit PrimaryKey vlastnost na žádné vytvořené DataTable. V těchto případech byste měli explicitně zadat primární klíče pro tabulky v DataSet.

Obsahuje OleDbDataAdapter také SelectCommandvlastnosti , InsertCommand, DeleteCommandUpdateCommand, a, které TableMappings usnadňují načítání a aktualizaci dat.

Když vytvoříte instanci OleDbDataAdapternástroje , vlastnosti se nastaví na jejich počáteční hodnoty. Seznam těchto hodnot najdete v konstruktoru OleDbDataAdapter .

Konstruktory

OleDbDataAdapter()	Inicializuje novou instanci OleDbDataAdapter třídy.
OleDbDataAdapter(OleDbCommand)	Inicializuje novou instanci OleDbDataAdapter třídy se zadaným OleDbCommand jako SelectCommand vlastnost.
OleDbDataAdapter(String, OleDbConnection)	Inicializuje novou instanci OleDbDataAdapter třídy pomocí SelectCommand.
OleDbDataAdapter(String, String)	Inicializuje novou instanci OleDbDataAdapter třídy pomocí SelectCommand.

Pole

DefaultSourceTableName

Výchozí název používaný objektem DataAdapter pro mapování tabulek. (Zděděno od DbDataAdapter)

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 . (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 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. (Zděděno od DataAdapter)
DeleteCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru pro odstranění záznamů z datové sady.
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)
FillCommandBehavior	Získá nebo nastaví chování příkazu použitého k vyplnění datového adaptéru. (Zděděno od DbDataAdapter)
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 SQL nebo uloženou proceduru, která se používá 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ž stávají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 cls kompatibilní hodnoty. (Zděděno od DataAdapter)
SelectCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru použitou k výběru záznamů ve zdroji dat.
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 . (Zděděno od DataAdapter)
UpdateBatchSize	Získá nebo nastaví hodnotu, která povoluje nebo zakazuje podporu dávkového zpracování a určuje počet příkazů, které lze spustit v dávce. (Zděděno od DbDataAdapter)
UpdateCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru sloužící k aktualizaci záznamů ve zdroji dat.

Metody

AddToBatch(IDbCommand)	Přidá do IDbCommand aktuální dávky . (Zděděno od DbDataAdapter)
ClearBatch()	Odebere všechny IDbCommand objekty z dávky. (Zděděno od DbDataAdapter)
CloneInternals()	Zastaralé. Vytvoří kopii této instance objektu DataAdapter. (Zděděno od 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)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializuje novou instanci RowUpdatedEventArgs třídy. (Zděděno od DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializuje novou instanci RowUpdatingEventArgs třídy. (Zděděno od DbDataAdapter)
CreateTableMappings()	Vytvoří nový objekt 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 nástrojem a volitelně uvolní spravované prostředky. (Zděděno od DbDataAdapter)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExecuteBatch()	Spustí aktuální dávku. (Zděděno od DbDataAdapter)
Fill(DataSet)	Přidá nebo aktualizuje řádky v objektu DataSet. (Zděděno od DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	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 . (Zděděno od DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Přidá nebo aktualizuje řádky v zadané oblasti v objektu DataSet tak, aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvů a zdrojových tabulek, řetězce příkazů a chování příkazů. (Zděděno od DbDataAdapter)
Fill(DataSet, Object, String)	Přidá nebo aktualizuje řádky v objektu DataSet tak, aby odpovídaly řádkům v objektu ADO Recordset nebo Record objektu pomocí zadaného DataSetnázvu , objektu ADO a názvu zdrojové tabulky.
Fill(DataSet, String)	Přidá nebo aktualizuje řádky v objektu tak, DataSet aby odpovídaly řádkům ve zdroji DataSet dat pomocí názvů a DataTable . (Zděděno od DbDataAdapter)
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 dat pomocí DataSetnázvů , DataTablea IDataReader . (Zděděno od DbDataAdapter)
Fill(DataTable)	Pomocí názvu přidá nebo aktualizuje řádky v zadané oblasti v DataSet poli tak, aby odpovídaly řádkům ve zdroji DataTable dat. (Zděděno od DbDataAdapter)
Fill(DataTable, IDataReader)	Přidá nebo aktualizuje řádky v objektu tak, DataTable aby odpovídaly řádkům ve zdroji dat pomocí zadaných DataTable názvů a IDataReader názvů. (Zděděno od DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Přidá nebo aktualizuje řádky v objektu DataTable tak, aby odpovídaly řádkům ve zdroji dat pomocí zadaných DataTablehodnot , IDbCommand a CommandBehavior. (Zděděno od DbDataAdapter)
Fill(DataTable, Object)	Přidá nebo aktualizuje řádky v objektu DataTable tak, aby odpovídaly řádkům v objektu ADO Recordset nebo Record objektu pomocí zadaných DataTable a objektů ADO.
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 v objektu DataSet tak, aby odpovídaly řádkům ve zdroji DataSet dat pomocí názvů a DataTable . (Zděděno od DbDataAdapter)
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ů. (Zděděno od DbDataAdapter)
FillSchema(DataSet, SchemaType)	Přidá pojmenovanou DataTable "Tabulku" k zadanému DataSet a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaného SchemaType. (Zděděno od DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	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. (Zděděno od DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	DataTable Přidá k zadanému DataSet a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaných SchemaType a DataTable. (Zděděno od DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Přidá do zadaného DataSetparametru DataTable . (Zděděno od DataAdapter)
FillSchema(DataTable, SchemaType)	Nakonfiguruje schéma zadaného DataTable na základě zadaného SchemaType. (Zděděno od DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Přidá do zadaného DataSetparametru DataTable . (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. (Zděděno od DbDataAdapter)
GetBatchedParameter(Int32, Int32)	IDataParameter Vrátí příkaz z jednoho z příkazů v aktuální dávce. (Zděděno od DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Vrátí informace o jednotlivých pokusech o aktualizaci v rámci větší dávkové aktualizace. (Zděděno od DbDataAdapter)
GetFillParameters()	Získá parametry nastavené uživatelem při spuštění příkazu SQL SELECT. (Zděděno od DbDataAdapter)
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. (Zděděno od DataAdapter)
InitializeBatching()	Inicializuje dávkování pro DbDataAdapter. (Zděděno od DbDataAdapter)
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)	FillError Vyvolá událost. (Zděděno od DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	RowUpdated Vyvolá událost zprostředkovatele dat .NET. (Zděděno od DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	RowUpdating Vyvolá událost zprostředkovatele dat .NET. (Zděděno od DbDataAdapter)
ResetFillLoadOption()	FillLoadOption Obnoví výchozí stav a způsobíFill(DataSet), že bude respektovat AcceptChangesDuringFill. (Zděděno od DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Určuje, zda má AcceptChangesDuringFill být vlastnost trvalá. (Zděděno od DataAdapter)
ShouldSerializeFillLoadOption()	Určuje, zda má FillLoadOption být vlastnost trvalá. (Zděděno od DataAdapter)
ShouldSerializeTableMappings()	Určuje, zda existuje jeden nebo více DataTableMapping objektů a měly by být trvalé. (Zděděno od DataAdapter)
TerminateBatching()	Ukončí dávkování pro DbDataAdapter. (Zděděno od 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[])	Aktualizace 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 objektu DataSet. (Zděděno od DbDataAdapter)
Update(DataRow[], DataTableMapping)	Aktualizace 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 DataRow poli objektů. (Zděděno od DbDataAdapter)
Update(DataSet)	Aktualizace 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 . (Zděděno od DbDataAdapter)
Update(DataSet, String)	Aktualizace 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. (Zděděno od DbDataAdapter)
Update(DataTable)	Aktualizace 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 . (Zděděno od DbDataAdapter)

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ě. (Zděděno od DbDataAdapter)
RowUpdated	Dochází během Update(DataSet) spuštění příkazu proti zdroji dat. Pokus o aktualizaci je proveden. Proto dojde k události.
RowUpdating	Probíhá během Update(DataSet) před spuštěním příkazu pro zdroj dat. Pokus o aktualizaci je proveden. Proto dojde k události.

Explicitní implementace rozhraní

ICloneable.Clone()	Popis tohoto člena najdete v tématu Clone().
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	Popis tohoto člena najdete v tématu DeleteCommand.
IDbDataAdapter.InsertCommand	Popis tohoto člena najdete v tématu InsertCommand.
IDbDataAdapter.SelectCommand	Popis tohoto člena najdete v tématu SelectCommand.
IDbDataAdapter.UpdateCommand	Popis tohoto člena najdete v tématu UpdateCommand.

Viz také

• Adaptéry a čtečky dat