OleDbDataAdapter Osztály

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.OleDb.dll

Csomag:

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

Forrás:

OleDbDataAdapter.cs

Az adatforrás kitöltéséhez DataSet és frissítéséhez használt adatparancsokat és adatbázis-kapcsolatot jelöli.

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Öröklődés

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Attribútumok

RequiresDynamicCodeAttribute

Megvalósítás

IDataAdapter IDbDataAdapter ICloneable

Példák

Az alábbi példa a OleDbCommandrekordok OleDbDataAdapter Access-adatforrásból való kiválasztására és OleDbConnectiona kijelölt sorok kitöltésére DataSet használja. Ezután visszaadja a kitöltött elemet DataSet . Ennek elvégzéséhez a metódus egy inicializált DataSet, egy kapcsolati karakterlánc és egy SQL SELECT utasítást tartalmazó lekérdezési sztringet ad át.

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

Megjegyzések

Ez OleDbDataAdapter 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 OleDbDataAdapter 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.

Amikor a OleDbDataAdapter kitöltés egy DataSet, akkor létrehozza a megfelelő táblákat és oszlopokat a visszaadott adatokhoz, 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 isOleDbDataAdapter, mielőtt adatokat töltené ki a használatávalDataSet.FillSchema További információ: Meglévő megkötések hozzáadása adathalmazhoz.

Vegye figyelembe, hogy egyes OLE DB-szolgáltatók, beleértve az MSDataShape szolgáltatót, nem adnak vissza alaptáblát vagy elsődleges kulcsadatokat. Ezért a OleDbDataAdapter tulajdonság nem állítható be megfelelően a PrimaryKey létrehozott DataTable. Ezekben az esetekben kifejezetten meg kell adnia a táblák elsődleges kulcsait a DataSet.

Az OleDbDataAdapter 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.

Amikor létrehoz egy példányt OleDbDataAdapter, a tulajdonságok a kezdeti értékekre lesznek állítva. Ezeknek az értékeknek a listáját a konstruktorban OleDbDataAdapter találja.

Konstruktorok

Name	Description
OleDbDataAdapter()	Inicializálja a OleDbDataAdapter osztály új példányát.
OleDbDataAdapter(OleDbCommand)	Inicializálja az osztály új példányát OleDbDataAdapter a megadott OleDbCommandSelectCommand tulajdonsággal.
OleDbDataAdapter(String, OleDbConnection)	Inicializálja az osztály új példányát OleDbDataAdapter egy SelectCommand.
OleDbDataAdapter(String, String)	Inicializálja az osztály új példányát OleDbDataAdapter egy SelectCommand.

Tulajdonságok

Name	Description
DeleteCommand	Lekéri vagy beállít egy SQL-utasítást vagy tárolt eljárást a rekordok adatkészletből való törléséhez.
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.

Metódusok

Name	Description
Fill(DataSet, Object, String)	A megadott, ADO-objektum és forrástáblanév használatával sorokat ad DataSethozzá vagy frissít egy ADO-objektumban Recordset vagy Record objektumban lévő sorokkalDataSet.
Fill(DataTable, Object)	A megadott és ADO-objektumokkal egyező sorokat DataTable ad Recordset hozzá vagy frissít egy adott ADO-objektumban Record vagy DataTable objektumban.

esemény

Name	Description
RowUpdated	Az adatforráson végrehajtott parancsok során Update(DataSet) történik. A frissítési kísérlet megtörtént. Ezért az esemény bekövetkezik.
RowUpdating	Ez akkor Update(DataSet) fordul elő, amikor egy parancs végrehajtása az adatforráson történik. A frissítési kísérlet megtörtént. Ezért az esemény bekövetkezik.

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