OdbcDataAdapter Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

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

Zdroj:

OdbcDataAdapter.cs

Představuje sadu příkazů dat a připojení ke zdroji dat, které se používají k vyplnění DataSet a aktualizaci zdroje dat. Tato třída se nemůže dědit.

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

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

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

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Dědičnost

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Příklady

Následující příklad používá OdbcCommand, OdbcDataAdaptera OdbcConnection k výběru záznamů a naplnění DataSet vybranými řádky.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter =
            new OdbcDataAdapter(queryString, connection);

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Poznámky

Slouží OdbcDataAdapter jako most mezi DataSet zdrojem dat a pro načítání a ukládání dat. Poskytuje OdbcDataAdapter 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í OdbcDataAdapterDataSet, vytvoří požadované 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 OdbcDataAdapter 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.

Poznámka

Když zavoláte metodu Fill u zdroje dat, který nemá sloupec primárního klíče, OdbcDataAdapter pokusí se zvýšit úroveň sloupce jedinečného omezení na primární klíč. V procesu označí OdbcDataAdapter jedinečné omezení jako nenulovatelné. Toto chování funguje, pokud ve sloupci jedinečného omezení není hodnota null. Pokud existuje hodnota null, Fill metoda selže s porušením omezení. Chcete-li se této situaci vyhnout, nepovolujte hodnoty null ve sloupci jedinečného omezení.

Poznámka

Vzhledem k omezením nativních ovladačů ODBC se při volání FillSchemavrátí pouze jeden DataTable z nich. To platí i při spouštění dávkových příkazů SQL, od kterých by se očekávalo více DataTable objektů.

Obsahuje OdbcDataAdapter také SelectCommandvlastnosti , InsertCommand, DeleteCommandUpdateCommand, a pro TableMappings usnadnění načítání a aktualizace dat.

Konstruktory

OdbcDataAdapter()	Inicializuje novou instanci OdbcDataAdapter třídy .
OdbcDataAdapter(OdbcCommand)	Inicializuje novou instanci OdbcDataAdapter třídy pomocí zadaného příkazu SQL SELECT.
OdbcDataAdapter(String, OdbcConnection)	Inicializuje novou instanci OdbcDataAdapter třídy pomocí příkazu SQL SELECT a OdbcConnection.
OdbcDataAdapter(String, String)	Inicializuje novou instanci OdbcDataAdapter třídy pomocí příkazu SQL SELECT a připojovací řetězec.

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 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 Update(DataSet)během . (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í sql příkaz nebo uložená procedura slouží k odstranění záznamů ve zdroji dat.
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í sql příkaz nebo uložená procedura slouží 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, pokud 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 by měla vrátit hodnoty specifické pro zprostředkovatele nebo běžné hodnoty kompatibilní s CLS. (Zděděno od DataAdapter)
SelectCommand	Získá nebo nastaví sql příkaz nebo uložená procedura slouží k výběru záznamů ve zdroji dat.
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 . (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. (Zděděno od DbDataAdapter)
UpdateCommand	Získá nebo nastaví sql příkaz nebo uložená procedura slouží 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 z dávky všechny IDbCommand objekty. (Zděděno od DbDataAdapter)
CloneInternals()	Zastaralé. Vytvoří kopii této instance .DataAdapter (Zděděno od 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)
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é nástrojem DbDataAdapter 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 aby odpovídaly řádkům ve zdroji dat pomocí DataSet 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 tak DataSet , aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvů zdrojových tabulek a , řetězce příkazů a chování příkazu. (Zděděno od DbDataAdapter)
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 tak DataSet , aby odpovídaly řádkům ve zdroji dat pomocí DataSetnázvů , DataTablea IDataReader . (Zděděno od DbDataAdapter)
Fill(DataTable)	Přidá nebo aktualizuje řádky v zadané oblasti v objektu tak DataSet , aby odpovídaly řádkům ve zdroji dat pomocí názvu DataTable . (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 . (Zděděno od DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Přidá nebo aktualizuje řádky v objektu tak DataTable , aby odpovídaly řádkům ve zdroji dat pomocí zadaných DataTablehodnot , IDbCommand a CommandBehavior. (Zděděno od DbDataAdapter)
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 aby odpovídaly řádkům ve zdroji dat pomocí DataSet 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čtení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 hodnot 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)	Vrátí hodnotu IDataParameter 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 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()	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á ž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)	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 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 existuje jeden nebo více DataTableMapping objektů a měly by být zachovány. (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 , Componentpokud 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 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 poli DataRow 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 DataSetobjektu . (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 objektu DataSet se zadaným DataTable názvem. (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 DataTableobjektu . (Zděděno od DbDataAdapter)

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ě. (Zděděno od DbDataAdapter)
RowUpdated	Vyvolá se během operace aktualizace po provedení příkazu proti zdroji dat.
RowUpdating	Vyskytuje se během Update(DataSet) před provedením příkazu proti zdroji dat.

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