OdbcDataAdapter Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
- Dědičnost
- Implementuje
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 |
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é.
Zastaralé.
Zastaralé.
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) |
|
OnRowUpdating(RowUpdatingEventArgs) |
|
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. |