OleDbDataAdapter Класс

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v9.0.0-rc.1.24431.7

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

OleDbDataAdapter.cs

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

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

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

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

Реализации

IDataAdapter IDbDataAdapter ICloneable

Примеры

В следующем примере используются OleDbCommand, OleDbDataAdapter и OleDbConnectionдля выбора записей из источника данных 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 режиме, в источник данных.

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

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

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

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

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

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

Поля

DefaultSourceTableName

Имя по умолчанию, используемое объектом DataAdapter для сопоставлений таблиц. (Унаследовано от DbDataAdapter)

Свойства

AcceptChangesDuringFill	Возвращает или задает значение, указывающее, вызывается ли метод AcceptChanges() в объекте DataRow после его добавления к объекту DataTable при выполнении любой из операций Fill. (Унаследовано от DataAdapter)
AcceptChangesDuringUpdate	Возвращает или задает, вызывается ли метод AcceptChanges() при вызове метода Update(DataSet). (Унаследовано от DataAdapter)
CanRaiseEvents	Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
Container	Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component)
ContinueUpdateOnError	Возвращает или задает значение, указывающее, следует ли генерировать ли исключение при обнаружении ошибки во время обновления строки. (Унаследовано от DataAdapter)
DeleteCommand	Возвращает или задает оператор SQL или хранимую процедуру для удаления записей из набора данных.
DesignMode	Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component)
Events	Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component)
FillCommandBehavior	Возвращает или задает реакцию команды, использованной для заполнения адаптера данных. (Унаследовано от DbDataAdapter)
FillLoadOption	Возвращает или задает значение перечисления типа LoadOption, определяющее, как адаптер заполняет объект DataTable из объекта DbDataReader. (Унаследовано от DataAdapter)
InsertCommand	Возвращает или задает инструкцию либо хранимую процедуру SQL, используемую для вставки записей в источнике данных.
MissingMappingAction	Определяет действие, выполняемое, если входные данные не соответствуют таблице или столбцу. (Унаследовано от DataAdapter)
MissingSchemaAction	Определяет действие, которое должно быть выполнено, если существующая схема DataSet не соответствует входным данным. (Унаследовано от DataAdapter)
ReturnProviderSpecificTypes	Возвращает или задает, должен ли метод Fill возвращать зависящие от поставщика значения или обычные CLS-совместимые значения. (Унаследовано от DataAdapter)
SelectCommand	Возвращает или задает оператор SQL или хранимую процедуру для выборки записей в источнике данных.
Site	Получает или задает ISite объекта Component. (Унаследовано от Component)
TableMappings	Возвращает коллекцию, которая предоставляет основное сопоставление между исходной таблицей DataTableи . (Унаследовано от DataAdapter)
UpdateBatchSize	Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые могут выполняться в рамках одного пакета. (Унаследовано от DbDataAdapter)
UpdateCommand	Возвращает или задает инструкцию SQL либо хранимую процедуру (используется для обновления записей в источнике данных).

Методы

AddToBatch(IDbCommand)	Добавляет интерфейс IDbCommand к текущему пакету. (Унаследовано от DbDataAdapter)
ClearBatch()	Удаляет все объекты IDbCommand из пакета. (Унаследовано от DbDataAdapter)
CloneInternals()	Устаревшие.. Создает дубликат этого экземпляра класса DataAdapter. (Унаследовано от DataAdapter)
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Инициализирует новый экземпляр класса RowUpdatedEventArgs. (Унаследовано от DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Инициализирует новый экземпляр класса RowUpdatingEventArgs. (Унаследовано от DbDataAdapter)
CreateTableMappings()	Создает новый экземпляр DataTableMappingCollection. (Унаследовано от DataAdapter)
Dispose()	Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DbDataAdapter, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbDataAdapter)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ExecuteBatch()	Выполняет текущий пакет. (Унаследовано от DbDataAdapter)
Fill(DataSet)	Добавляет или обновляет строки в объекте DataSet. (Унаследовано от DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и DataTable. (Унаследовано от DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с помощью имен DataSet и исходной таблицы, командной строки и поведения команды. (Унаследовано от DbDataAdapter)
Fill(DataSet, Object, String)	Добавляет или обновляет строки в наборе DataSet для соответствия строкам в объекте ADO Recordset или Record с помощью указанного набора DataSet, объекта ADO и имени таблицы источника.
Fill(DataSet, String)	Добавляет или обновляет строки в объекте DataSet для получения соответствия строкам в источнике данных с помощью имен DataSet и DataTable. (Унаследовано от DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet, DataTable и IDataReader. (Унаследовано от DbDataAdapter)
Fill(DataTable)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имени DataTable. (Унаследовано от DbDataAdapter)
Fill(DataTable, IDataReader)	Добавляет или обновляет строки в объекте DataTable для получения соответствия строкам в источнике данных с помощью указанных имен DataTable и IDataReader. (Унаследовано от DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в объекте DataTable для получения соответствия строкам в источнике данных с помощью указанного объекта DataTable, интерфейса IDbCommand и значения типа CommandBehavior. (Унаследовано от DbDataAdapter)
Fill(DataTable, Object)	Добавляет или обновляет строки в DataTable для соответствия строкам в объекте ADO Recordset или Record с помощью указанной таблицы DataTable и объектов ADO.
Fill(DataTable[], IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанной коллекции объектов DataTable для получения соответствия строкам в источнике данных. (Унаследовано от DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и DataTable. (Унаследовано от DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Добавляет или обновляет строки в одном или нескольких объектах DataTable в соответствии с строками в источнике данных, начиная с указанной записи и извлекая до указанного максимального количества записей. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType)	Добавляет объект DataTable с именем Table в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанного значения типа SchemaType. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Добавляет объект DataTable в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанного значения типа SchemaType. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	Добавляет объект DataTable в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанных SchemaType и DataTable. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Добавляет объект DataTable к указанному объекту DataSet. (Унаследовано от DataAdapter)
FillSchema(DataTable, SchemaType)	Настраивает схему указанного объекта DataTable на основе указанного SchemaType. (Унаследовано от DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Добавляет объект DataTable к указанному объекту DataSet. (Унаследовано от DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Настраивает схему для указанного объекта DataTable, основываясь на указанном значении типа SchemaType, командной строке и значениях типа CommandBehavior. (Унаследовано от DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Возвращает интерфейс IDataParameter из одной из команд в текущем пакете. (Унаследовано от DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Возвращает сведения об отдельной попытке обновления в рамках большего по своему объему пакета обновления. (Унаследовано от DbDataAdapter)
GetFillParameters()	Получает параметры, заданные пользователем при выполнении оператора SQL SELECT. (Унаследовано от DbDataAdapter)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HasTableMappings()	Указывает, был ли создан DataTableMappingCollection. (Унаследовано от DataAdapter)
InitializeBatching()	Инициализирует пакетную обработку для объекта DbDataAdapter. (Унаследовано от DbDataAdapter)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Вызывает событие FillError. (Унаследовано от DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Вызывает событие RowUpdated поставщика данных .NET. (Унаследовано от DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Вызывает событие RowUpdating поставщика данных .NET. (Унаследовано от DbDataAdapter)
ResetFillLoadOption()	Сбрасывает свойство FillLoadOption к состоянию по умолчанию и вызывает метод Fill(DataSet) для обеспечения поддержки свойства AcceptChangesDuringFill. (Унаследовано от DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Определяет, должно ли сохраняться свойство AcceptChangesDuringFill. (Унаследовано от DataAdapter)
ShouldSerializeFillLoadOption()	Определяет, должно ли сохраняться свойство FillLoadOption. (Унаследовано от DataAdapter)
ShouldSerializeTableMappings()	Определяет, существует ли один или несколько объектов DataTableMapping и нужно ли их сохранить. (Унаследовано от DataAdapter)
TerminateBatching()	Завершает пакетную обработку для объекта DbDataAdapter. (Унаследовано от DbDataAdapter)
ToString()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)
Update(DataRow[])	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве объектов DataSet. (Унаследовано от DbDataAdapter)
Update(DataRow[], DataTableMapping)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве объектов DataRow. (Унаследовано от DbDataAdapter)
Update(DataSet)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном DataSet. (Унаследовано от DbDataAdapter)
Update(DataSet, String)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в DataSet с заданным именем DataTable. (Унаследовано от DbDataAdapter)
Update(DataTable)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном DataTable. (Унаследовано от DbDataAdapter)

События

Disposed	Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)
FillError	Возвращается при возникновении ошибки во время работы операции заполнения. (Унаследовано от DbDataAdapter)
RowUpdated	Происходит во время Update(DataSet) после выполнения команды для источника данных. Предпринята попытка обновления. Следовательно, происходит событие.
RowUpdating	Происходит во время Update(DataSet) перед выполнением команды в отношении источника данных. Предпринята попытка обновления. Следовательно, происходит событие.

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

ICloneable.Clone()	Описание этого члена см. в разделе Clone().
IDataAdapter.TableMappings	Возвращает коллекцию, указывающую, как исходная таблица сопоставляется с таблицей набора данных. (Унаследовано от DataAdapter)
IDbDataAdapter.DeleteCommand	Описание этого члена см. в разделе DeleteCommand.
IDbDataAdapter.InsertCommand	Описание этого члена см. в разделе InsertCommand.
IDbDataAdapter.SelectCommand	Описание этого члена см. в разделе SelectCommand.
IDbDataAdapter.UpdateCommand	Описание этого члена см. в разделе UpdateCommand.

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

• Объекты DataAdapter и DataReader