OdbcDataAdapter Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v11.0.0-preview.2.26159.112

Zdroj:

OdbcDataAdapter.cs

Představuje sadu datových příkazů a připojení ke zdroji dat, který slouží k vyplnění DataSet a aktualizaci zdroje dat. Tuto třídu nelze zdě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 zdrojem dat pro načítání a ukládání dat. Tento OdbcDataAdapter most poskytuje použití Fill k načtení dat ze zdroje dat do DataSeta použití Update k odesílání změn provedených DataSet zpět do zdroje dat.

OdbcDataAdapter Když vyplní , DataSetvytvoří 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, pokud MissingSchemaAction není vlastnost nastavena na AddWithKey. Před vyplněním dat FillSchemamůžete také vytvořit OdbcDataAdapter schéma objektu DataSet, včetně informací o primárním klíči. Další informace naleznete v tématu Přidání existujících omezení do datové sady.

Poznámka:

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

Poznámka:

Vzhledem k omezením nativních ovladačů ODBC se při volání FillSchemavždy vrátí pouze jeden DataTable ovladač . To platí i při provádění dávkových příkazů SQL, ze kterých by se očekávalo více DataTable objektů.

Zahrnuje OdbcDataAdapter také SelectCommandvlastnosti , , , DeleteCommandInsertCommandUpdateCommanda TableMappings vlastnosti pro usnadnění načítání a aktualizace dat.

Konstruktory

Name	Description
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 příkazem SQL SELECT a .OdbcConnection
OdbcDataAdapter(String, String)	Inicializuje novou instanci OdbcDataAdapter třídy příkazem SQL SELECT a připojovacím řetězcem.

Vlastnosti

Name	Description
DeleteCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru použitou k odstranění záznamů ve zdroji dat.
InsertCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru použitou k vložení nových záznamů do zdroje dat.
SelectCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru použitou k výběru záznamů ve zdroji dat.
UpdateCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru použitou k aktualizaci záznamů ve zdroji dat.

Událost

Name	Description
RowUpdated	Nastane během operace aktualizace po provedení příkazu ve zdroji dat.
RowUpdating	Nastane během Update(DataSet) před spuštěním příkazu ve zdroji dat.

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Popis tohoto člena naleznete v tématu Clone().
IDbDataAdapter.DeleteCommand	Popis tohoto člena naleznete v tématu DeleteCommand.
IDbDataAdapter.InsertCommand	Popis tohoto člena naleznete v tématu InsertCommand.
IDbDataAdapter.SelectCommand	Popis tohoto člena naleznete v tématu SelectCommand.
IDbDataAdapter.UpdateCommand	Popis tohoto člena naleznete v tématu UpdateCommand.

Viz také

• Datové adaptéry a čtečky dat