OleDbDataAdapter Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

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

Zdroj:

OleDbDataAdapter.cs

Představuje sadu datových příkazů a databázové připojení, které slouží k vyplnění DataSet a aktualizaci zdroje dat.

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

Dědičnost

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Atributy

RequiresDynamicCodeAttribute

Implementuje

IDataAdapter IDbDataAdapter ICloneable

Příklady

Následující příklad používá k výběru záznamů ze zdroje DataSet dat Accessu OleDbCommandOleDbDataAdapter a OleDbConnectionnaplnění vybranými řádky. Vyplněný DataSet se pak vrátí. K tomu se metoda předá inicializovanému DataSet, připojovacímu řetězci a řetězci dotazu, který je příkazem SQL SELECT.

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

Poznámky

Slouží OleDbDataAdapter jako most mezi DataSet zdrojem dat a zdrojem dat pro načítání a ukládání dat. Tento OleDbDataAdapter 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.

OleDbDataAdapter Po vyplnění DataSetvytvoří příslušné 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 OleDbDataAdapter 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.

Všimněte si, že někteří zprostředkovatelé OLE DB, včetně zprostředkovatele MSDataShape, nevrací základní tabulku ani informace o primárním klíči. OleDbDataAdapter Nelze proto správně nastavit vlastnost u žádného vytvořeného DataTableobjektu PrimaryKey . V těchto případech byste měli explicitně zadat primární klíče pro tabulky v sadě DataSet.

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

Při vytváření instance , OleDbDataAdaptervlastnosti jsou nastaveny na jejich počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru OleDbDataAdapter .

Konstruktory

Name	Description
OleDbDataAdapter()	Inicializuje novou instanci OleDbDataAdapter třídy.
OleDbDataAdapter(OleDbCommand)	Inicializuje novou instanci OleDbDataAdapter třídy se zadaným OleDbCommand jako SelectCommand vlastnost.
OleDbDataAdapter(String, OleDbConnection)	Inicializuje novou instanci OleDbDataAdapter třídy pomocí SelectCommand.
OleDbDataAdapter(String, String)	Inicializuje novou instanci OleDbDataAdapter třídy pomocí SelectCommand.

Vlastnosti

Name	Description
DeleteCommand	Získá nebo nastaví příkaz SQL nebo uloženou proceduru pro odstranění záznamů z datové sady.
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.

Metody

Name	Description
Fill(DataSet, Object, String)	Přidá nebo aktualizuje řádky odpovídající DataSet řádkům v objektu ADO Recordset nebo Record objektu pomocí zadaného DataSetobjektu, objektu ADO a názvu zdrojové tabulky.
Fill(DataTable, Object)	Přidá nebo aktualizuje řádky tak DataTable , aby odpovídaly řádkům v objektu ADO Recordset nebo Record objektu pomocí zadaných DataTable a objektů ADO.

Událost

Name	Description
RowUpdated	Nastane během Update(DataSet) po provedení příkazu proti zdroji dat. Provede se pokus o aktualizaci. Proto dojde k události.
RowUpdating	Nastane během Update(DataSet) před spuštěním příkazu ve zdroji dat. Provede se pokus o aktualizaci. Proto dojde k události.

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