Поделиться через


OleDbDataAdapter Класс

Определение

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

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Наследование
Реализации

Примеры

В следующем примере используются 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.

Применяется к

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