DbDataAdapter Класс

Определение

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

Сборки:: netstandard.dll, System.Data.Common.dll

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

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

Сборка:: netstandard.dll

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

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

Исходный код:: 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 наследует IDbDataAdapter от DataAdapter класса и реализует интерфейс. Он помогает классу реализовать DataAdapter , предназначенный для использования с реляционной базой данных.

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

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

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

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

Пункт	Описание
PrvDataAdapter()	Инициализирует новый экземпляр класса PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Инициализирует новый экземпляр класса PrvDataAdapter с указанной инструкцией SQL SELECT.
PrvDataAdapter(string selectCommandText, строка 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	Возвращает или задает значение, указывающее, вызывается DataRow ли AcceptChanges() он после добавления в DataTable любой из операций заполнения. (Унаследовано от 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	Возвращает коллекцию, которая предоставляет первичное сопоставление между исходной таблицей и a 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, Int32, Int32, String, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в указанном диапазоне в DataSet соответствии DataSet с именами и именами исходной таблицы, командной строкой и поведением команд.
Fill(DataSet, Int32, Int32, 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(DataSet, String)	Добавляет или обновляет строки в DataSet соответствии с этими строками в источнике данных с помощью DataSet имен и DataTable имен.
Fill(DataSet)	Добавляет или обновляет строки в элементе DataSet.
Fill(DataTable, IDataReader)	Добавляет или обновляет строки в DataTable соответствии с указанными и IDataReader именами в источнике DataTable данных.
Fill(DataTable, IDataReader)	Добавляет или обновляет строки в DataTable соответствии с этими строками в источнике данных с помощью DataTable имени и указанного IDataReader. (Унаследовано от DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в DataTable соответствии с строками в источнике данных с помощью указанного DataTable IDbCommand и CommandBehavior.
Fill(DataTable)	Добавляет или обновляет строки в указанном диапазоне в DataSet соответствии с этими строками в источнике данных с помощью DataTable имени.
Fill(DataTable[], IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанном диапазоне в коллекции DataTable объектов, которые соответствуют этим строкам в источнике данных. (Унаследовано от DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в указанном диапазоне в DataSet соответствии с этими строками в источнике данных с помощью DataSet имен и DataTable имен.
Fill(Int32, Int32, DataTable[])	Добавляет или обновляет строки в одном или нескольких DataTable объектах, чтобы они соответствовали данным в источнике данных, начиная с указанной записи и извлекая до указанного максимального количества записей.
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Добавляет в DataTable указанный DataSet и настраивает схему для сопоставления в источнике данных на основе указанного SchemaType.
FillSchema(DataSet, SchemaType, String, IDataReader)	Добавляется в указанный DataTable DataSetобъект. (Унаследовано от DataAdapter)
FillSchema(DataSet, SchemaType, String)	Добавляет в DataTable указанный DataSet и настраивает схему для сопоставления в источнике данных на основе указанного SchemaType и DataTable.
FillSchema(DataSet, SchemaType)	DataTable Добавляет имя "Таблица" в указанный DataSet и настраивает схему для сопоставления в источнике данных на основе указанногоSchemaType.
FillSchema(DataTable, SchemaType, IDataReader)	Добавляется в указанный DataTable DataSetобъект. (Унаследовано от DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Настраивает схему указанного DataTable на основе указанной SchemaType, командной строки и CommandBehavior значений.
FillSchema(DataTable, SchemaType)	Настраивает схему указанного DataTable на основе указанного SchemaType.
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[], DataTableMapping)	Обновляет значения в базе данных путем выполнения соответствующих инструкций INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве DataRow объектов.
Update(DataRow[])	Обновляет значения в базе данных путем выполнения соответствующих инструкций INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве DataSet.
Update(DataSet, String)	Обновляет значения в базе данных путем выполнения соответствующих инструкций INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в строке DataSet с указанным DataTable именем.
Update(DataSet)	Обновляет значения в базе данных путем выполнения соответствующих инструкций INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанной строке DataSet.
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, строка selectConnectionString)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и строки подключения.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и объекта PrvConnection.

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