OleDbDataAdapter Класс

Определение

Пространство имен:

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

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

Исходный код:

OleDbDataAdapter.cs

Представляет набор команд данных и подключения к базе данных, которые используются для заполнения DataSet и обновления источника данных.

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

Наследование

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Атрибуты

RequiresDynamicCodeAttribute

Реализации

IDataAdapter IDbDataAdapter ICloneable

Примеры

В следующем примере используются OleDbCommandOleDbDataAdapterOleDbConnectionзаписи и записи из источника данных Access и заполнение DataSet выделенными строками. Затем возвращается заполнение DataSet . Для этого метод передает инициализированную DataSet, строку подключения и строку запроса, которая является инструкцией 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

Комментарии

Он OleDbDataAdapter служит мостом между DataSet источником данных и источником данных для получения и сохранения данных. Этот OleDbDataAdapter мост используется Fill для загрузки данных из источника данных в источник DataSetданных и отправки Update изменений, внесенных обратно в DataSet источник данных.

OleDbDataAdapter При заполнении DataSetон создаст соответствующие таблицы и столбцы для возвращаемых данных, если они еще не существуют. Однако данные первичного ключа не включаются в неявную созданную схему, если MissingSchemaAction свойство не задано AddWithKey. Кроме тогоOleDbDataAdapter, вы можете создать схему, включая сведения первичного DataSetключа, прежде чем заполнять их данными.FillSchema Дополнительные сведения см. в разделе "Добавление существующих ограничений в набор данных".

Обратите внимание, что некоторые поставщики OLE DB, включая поставщика MSDataShape, не возвращают базовую таблицу или сведения о первичном ключе. OleDbDataAdapter Поэтому невозможно правильно задать свойство для любого созданного PrimaryKeyDataTableобъекта. В этих случаях необходимо явно указать первичные ключи для таблиц в таблице DataSet.

Также OleDbDataAdapter включаются SelectCommandсвойства , InsertCommandDeleteCommandUpdateCommandи TableMappings свойства для упрощения загрузки и обновления данных.

При создании экземпляра OleDbDataAdapterсвойства задаются их начальными значениями. Список этих значений см. в конструкторе OleDbDataAdapter .

Конструкторы

Имя	Описание
OleDbDataAdapter()	Инициализирует новый экземпляр класса OleDbDataAdapter.
OleDbDataAdapter(OleDbCommand)	Инициализирует новый экземпляр OleDbDataAdapter класса с указанным OleDbCommand в качестве SelectCommand свойства.
OleDbDataAdapter(String, OleDbConnection)	Инициализирует новый экземпляр OleDbDataAdapter класса с помощью .SelectCommand
OleDbDataAdapter(String, String)	Инициализирует новый экземпляр OleDbDataAdapter класса с помощью .SelectCommand

Свойства

Имя	Описание
DeleteCommand	Возвращает или задает инструкцию SQL или хранимую процедуру для удаления записей из набора данных.
InsertCommand	Возвращает или задает инструкцию SQL или хранимую процедуру, используемую для вставки новых записей в источник данных.
SelectCommand	Возвращает или задает инструкцию SQL или хранимую процедуру, используемую для выбора записей в источнике данных.
UpdateCommand	Возвращает или задает инструкцию SQL или хранимую процедуру, используемую для обновления записей в источнике данных.

Методы

Имя	Описание
Fill(DataSet, Object, String)	Добавляет или обновляет строки в DataSet соответствии с именами в ADO Recordset или Record объекте с помощью указанного DataSetобъекта, объекта ADO и имени исходной таблицы.
Fill(DataTable, Object)	Добавляет или обновляет строки в соответствии с строками в DataTable объекте ADO Recordset или Record объекте с помощью указанных DataTable объектов и объектов ADO.

События

Имя	Описание
RowUpdated	Происходит во время выполнения Update(DataSet) команды в источнике данных. Предпринята попытка обновить. Таким образом, происходит событие.
RowUpdating	Происходит во время Update(DataSet) выполнения команды в источнике данных. Предпринята попытка обновить. Таким образом, происходит событие.

Явные реализации интерфейса

Имя	Описание
ICloneable.Clone()	Описание этого элемента см. в разделе Clone().
IDbDataAdapter.DeleteCommand	Описание этого элемента см. в разделе DeleteCommand.
IDbDataAdapter.InsertCommand	Описание этого элемента см. в разделе InsertCommand.
IDbDataAdapter.SelectCommand	Описание этого элемента см. в разделе SelectCommand.
IDbDataAdapter.UpdateCommand	Описание этого элемента см. в разделе UpdateCommand.

См. также раздел

• Объекты DataAdapter и DataReader