DataAdapter Класс

Определение

Пространство имен:

System.Data.Common

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

DataAdapter.cs

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

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

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataAdapter = class
    inherit Component
    interface IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

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

Object

MarshalByRefObject

Component

DataAdapter

Производный

System.Data.Common.DbDataAdapter

Атрибуты

DynamicallyAccessedMembersAttribute

Реализации

IDataAdapter

Комментарии

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

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

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

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

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

Свойства

Имя	Описание
AcceptChangesDuringFill	Возвращает или задает значение, указывающее, вызывается AcceptChanges() ли DataRow он после добавления в DataTable любой из операций заполнения.
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	Возвращает коллекцию, которая предоставляет первичное сопоставление между исходной таблицей и a DataTable.

Методы

Имя	Описание
CloneInternals()	Устаревшие.. Создает копию этого экземпляра DataAdapter.
CreateTableMappings()	Создает новый DataTableMappingCollectionобъект.
Dispose()	Освобождает все ресурсы, используемые параметром Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DataAdapter и при необходимости освобождает управляемые ресурсы.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Fill(DataSet, String, IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанном диапазоне в DataSet соответствии с этими строками в источнике данных с помощью DataSet имен и DataTable имен.
Fill(DataSet)	Добавляет или обновляет строки в DataSet соответствии с строками в источнике данных.
Fill(DataTable, IDataReader)	Добавляет или обновляет строки в DataTable соответствии с этими строками в источнике данных с помощью DataTable имени и указанного IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанном диапазоне в коллекции DataTable объектов, которые соответствуют этим строкам в источнике данных.
FillSchema(DataSet, SchemaType, String, IDataReader)	Добавляется в указанный DataTableDataSetобъект.
FillSchema(DataSet, SchemaType)	Добавляет в DataTable указанный DataSet и настраивает схему для сопоставления в источнике данных на основе указанного SchemaType.
FillSchema(DataTable, SchemaType, IDataReader)	Добавляется в указанный DataTableDataSetобъект.
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 для каждой вставленной, обновленной или удаленной строки в указанной DataSetDataTable строке с именем Table.

События

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

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

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

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

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