OleDbDataAdapter Třída

Definice

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
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Dědičnost
Implementuje

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é.
Zastaralé.
Zastaralé.
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.

Platí pro

Viz také