DataAdapter Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет набор команд SQL и подключение к базе данных, которые используются для заполнения DataSet и обновления источника данных.
public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapterpublic ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapterpublic class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapterpublic abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdaptertype DataAdapter = class
inherit Component
interface IDataAdapterPublic Class DataAdapter
Inherits Component
Implements IDataAdapterPublic MustInherit Class DataAdapter
Inherits Component
Implements 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 |
Возвращает или задает, должен ли метод |
| 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) | |
| FillSchema(DataTable, SchemaType, IDataReader) | |
| 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) |
Вызывается при возникновении ошибки, когда применяется метод |
| 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 |
Возвращает коллекцию, указывающую, как исходная таблица сопоставляется с таблицей набора данных. |
