OdbcDataAdapter Osztály

Definíció

Névtér:

System.Data.Odbc

Szerelvény:

System.Data.Odbc.dll

Csomag:

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

Forrás:

OdbcDataAdapter.cs

Adatparancsok halmazát és egy adatforráshoz való kapcsolatot jelöl, amelyek az DataSet adatforrás kitöltésére és frissítésére szolgálnak. Ez az osztály nem örökölhető.

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

Öröklődés

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Megvalósítás

IDataAdapter IDbDataAdapter ICloneable

Példák

Az alábbi példa a rekordok OdbcCommandkiválasztását és OdbcDataAdapter a kijelölt sorok kitöltését OdbcConnection használjaDataSet.

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

Megjegyzések

Ez OdbcDataAdapter hídként szolgál egy és egy DataSet adatforrás között az adatok lekéréséhez és mentéséhez. Ezt OdbcDataAdapter a hidat Fill úgy biztosítja, hogy adatokat tölt be az adatforrásból az DataSetadatforrásba, és visszaküldött Update módosításokat DataSet küld az adatforrásnak.

OdbcDataAdapter A kitöltéskor DataSetlétrehozza a visszaadott adatokhoz szükséges táblákat és oszlopokat, ha még nem léteznek. Az elsődleges kulcs információi azonban csak akkor szerepelnek az implicit módon létrehozott sémában, ha a MissingSchemaAction tulajdonság értéke AddWithKey. Az elsődleges kulcsadatokkal együtt létrehozhatja a sémát isOdbcDataAdapter, mielőtt adatokat töltené ki a használatávalDataSet.FillSchema További információ: Meglévő megkötések hozzáadása adathalmazhoz.

Note

Ha olyan adatforráson hívja meg a Fill metódust, amely nem rendelkezik elsődleges kulcsoszloppal, a OdbcDataAdapter metódus megpróbálja előléptetni az egyedi kényszeroszlopot az elsődleges kulcsra. A folyamat során az OdbcDataAdapter egyedi kényszert nem null értékűként jelöli meg. Ez a viselkedés csak akkor működik, ha az egyedi kényszeroszlopban null érték van. Null érték esetén a Fill metódus kényszersértéssel meghiúsul. A helyzet elkerülése érdekében ne engedélyezze a null értékeket az egyedi kényszeroszlopban.

Note

A natív ODBC-illesztőprogramok korlátozásai miatt a rendszer DataTablecsak egyet FillSchema ad vissza híváskor. Ez akkor is igaz, ha olyan SQL-kötegelt utasításokat hajt végre, amelyektől több DataTable objektum várható.

Az OdbcDataAdapter adatok betöltésének SelectCommandés frissítésének megkönnyítése érdekében a , InsertCommand, DeleteCommand, UpdateCommandés TableMappings tulajdonságokat is tartalmazza.

Konstruktorok

Name	Description
OdbcDataAdapter()	Inicializálja a OdbcDataAdapter osztály új példányát.
OdbcDataAdapter(OdbcCommand)	Inicializálja az OdbcDataAdapter osztály új példányát a megadott SQL SELECT utasítással.
OdbcDataAdapter(String, OdbcConnection)	Inicializálja az OdbcDataAdapter osztály új példányát egy SQL SELECT utasítással és egy OdbcConnection.
OdbcDataAdapter(String, String)	Inicializálja a OdbcDataAdapter osztály új példányát egy SQL SELECT utasítással és egy kapcsolati karakterlánc.

Tulajdonságok

Name	Description
DeleteCommand	Lekéri vagy beállítja az adatforrás rekordjainak törlésére szolgáló SQL-utasítást vagy tárolt eljárást.
InsertCommand	Lekéri vagy beállít egy SQL-utasítást vagy tárolt eljárást, amellyel új rekordokat szúrhat be az adatforrásba.
SelectCommand	Lekéri vagy beállít egy SQL-utasítást vagy tárolt eljárást az adatforrás rekordjainak kiválasztásához.
UpdateCommand	Lekéri vagy beállítja az adatforrás rekordjainak frissítéséhez használt SQL-utasítást vagy tárolt eljárást.

esemény

Name	Description
RowUpdated	A frissítési művelet során történik, miután egy parancsot végrehajtottak az adatforráson.
RowUpdating	Ez akkor Update(DataSet) fordul elő, amikor egy parancs végrehajtása az adatforráson történik.

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Ennek a tagnak a leírását lásd Clone(): .
IDbDataAdapter.DeleteCommand	Ennek a tagnak a leírását lásd DeleteCommand: .
IDbDataAdapter.InsertCommand	Ennek a tagnak a leírását lásd InsertCommand: .
IDbDataAdapter.SelectCommand	Ennek a tagnak a leírását lásd SelectCommand: .
IDbDataAdapter.UpdateCommand	Ennek a tagnak a leírását lásd UpdateCommand: .

Lásd még

• Adatadapterek és Adatolvasók