DataAdapter Класс

Ссылка

Определение

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

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

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

Сборка:: netstandard.dll

Важно!

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

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

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter

public ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapter

public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

public abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

type DataAdapter = class
    inherit Component
    interface IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

Public MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter

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

MarshalByRefObject

Component
DataAdapter

Производный: System.Data.Common.DbDataAdapter

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

служит DataAdapter мостом между DataSet и источником данных для получения и сохранения данных. предоставляет DataAdapter этот мост путем сопоставления Fill, который изменяет данные в DataSet , чтобы соответствовать данным в источнике данных, и Update, который изменяет данные в источнике данных в соответствии с данными DataSetв .

Если вы подключаетесь к базе данных SQL Server, можно повысить общую производительность, используя SqlDataAdapter вместе со связанными SqlCommand объектами и SqlConnection . Для источников данных, поддерживаемых OLE DB, используйте со связанными OleDbCommand объектами DataAdapter и OleDbConnection . Для источников данных, поддерживаемых ODBC, используйте со связанными OdbcCommand объектами DataAdapter и OdbcConnection . Для баз данных Oracle используйте со связанными OracleCommand объектами DataAdapter и OracleConnection .

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

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

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

Свойства

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

Методы

CloneInternals()	Устаревшие.. Устаревшие.. Устаревшие.. Устаревшие.. Создает дубликат этого экземпляра класса DataAdapter.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
CreateTableMappings()	Создает новый экземпляр DataTableMappingCollection.
Dispose()	Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DataAdapter, а при необходимости освобождает также управляемые ресурсы.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Fill(DataSet)	Добавляет или обновляет строки в DataSet для получения соответствия строкам в источнике данных.
Fill(DataSet, String, IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и DataTable.
Fill(DataTable, IDataReader)	Добавляет или обновляет строки в DataTable для получения соответствия строкам в источнике данных с помощью имени DataTable и указанного интерфейса IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанной коллекции объектов DataTable для получения соответствия строкам в источнике данных.
FillSchema(DataSet, SchemaType)	Добавляет объект DataTable в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанного значения типа SchemaType.
FillSchema(DataSet, SchemaType, String, IDataReader)	Добавляет объект DataTable к указанному объекту DataSet.
FillSchema(DataTable, SchemaType, IDataReader)	Добавляет объект DataTable к указанному объекту DataSet.
GetFillParameters()	Получает параметры, заданные пользователем при выполнении оператора SQL SELECT.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HasTableMappings()	Указывает, был ли создан DataTableMappingCollection.
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Вызывается при возникновении ошибки, когда применяется метод `Fill`.
ResetFillLoadOption()	Сбрасывает свойство FillLoadOption к состоянию по умолчанию и вызывает метод Fill(DataSet) для обеспечения поддержки свойства AcceptChangesDuringFill.
ShouldSerializeAcceptChangesDuringFill()	Определяет, должно ли сохраняться свойство AcceptChangesDuringFill.
ShouldSerializeFillLoadOption()	Определяет, должно ли сохраняться свойство FillLoadOption.
ShouldSerializeTableMappings()	Определяет, существует ли один или несколько объектов DataTableMapping и нужно ли их сохранить.
ToString()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)
Update(DataSet)	Вызывает соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном объекте DataSet из DataTable с именем "Table".

События

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

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

IDataAdapter.TableMappings

Возвращает коллекцию, указывающую, как исходная таблица сопоставляется с таблицей набора данных.

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

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

Общие сведения об ADO.NET