DbDataAdapter Класс

Ссылка

Определение

Пространство имен:: System.Data.Common

Сборка:: System.Data.Common.dll

Сборка:: System.Data.dll

Сборка:: netstandard.dll

Исходный код:: DbDataAdapter.cs

Исходный код:: DbDataAdapter.cs

Исходный код:: DbDataAdapter.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Помогает в реализации интерфейса IDbDataAdapter. Разработчики производных классов DbDataAdapter реализуют набор функций, обеспечивающий строгую типизацию, но наследуют большинство функций, необходимых для полной реализации DataAdapter.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable

public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter

public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable

type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

type DbDataAdapter = class
    inherit DataAdapter
    interface ICloneable

type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable

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

MarshalByRefObject

Component

DataAdapter
DbDataAdapter

Производный: System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Реализации: IDataAdapter IDbDataAdapter ICloneable

Класс DbDataAdapter наследует от DataAdapter класса и реализует IDbDataAdapter интерфейс . Это помогает классу реализовать DataAdapter, предназначенный для использования с реляционной базой данных.

Приложение не создает экземпляр DbDataAdapter класса напрямую, а создает экземпляр класса, который наследуется от него.

Наследуемые DbDataAdapter классы должны реализовывать унаследованные члены и, как правило, определять дополнительные члены для добавления функций, зависящих от поставщика. Например, DbDataAdapter класс определяет SelectCommand свойство , а DbDataAdapter класс определяет восемь перегрузок Fill метода . В свою очередь, OleDbDataAdapter класс наследует Fill метод , а также определяет две дополнительные перегрузки Fill , которые принимают объект ADO Recordset в качестве параметра.

Примечания для тех, кто реализует этот метод

При наследовании DbDataAdapter от класса рекомендуется реализовать следующие конструкторы:

Элемент	Описание
PrvDataAdapter()	Инициализирует новый экземпляр класса PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью указанной инструкции SQL SELECT.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и строки подключения.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и объекта PrvConnection.

Чтобы повысить согласованность между поставщиками данных платформа .NET Framework, следует назвать наследующий класс в формате PrvDataAdapter, где Prv — это универсальный префикс, предоставленный всем классам в определенном пространстве имен поставщика данных платформа .NET Framework. Например, "Sql" — это префикс SqlDataAdapter класса в пространстве имен System.Data.SqlClient .

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

DbDataAdapter()	Инициализирует новый экземпляр класса DataAdapter.
DbDataAdapter(DbDataAdapter)	Инициализирует новый экземпляр `DataAdapter` класса из существующего объекта того же типа.

Поля

DefaultSourceTableName

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

Свойства

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

Методы

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

События

Disposed	Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)
FillError	Возвращается при возникновении ошибки во время работы операции заполнения.
FillError	Возвращается при возникновении ошибки во время работы операции заполнения. (Унаследовано от DataAdapter)

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

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

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

Элемент	Описание
PrvDataAdapter()	Инициализирует новый экземпляр класса PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью указанной инструкции SQL SELECT.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и строки подключения.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и объекта PrvConnection.