DbDataAdapter Класс

Определение

Помогает в реализации интерфейса 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
Наследование
Производный
Реализации

Комментарии

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

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

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

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

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

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

Чтобы повысить согласованность между поставщиками данных платформа .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 для обновления записей в источнике данных.

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

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