DataAdapter Класс

Определение

Представляет набор команд SQL и подключение к базе данных, которые используются для заполнения DataSet и обновления источника данных.Represents a set of SQL commands and a database connection that are used to fill the DataSet and update the data source.

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
type DataAdapter = class
    inherit Component
    interface IDataAdapter
Public Class DataAdapter
Inherits Component
Implements IDataAdapter
Наследование
Производный
Реализации

Комментарии

DataAdapter выступает в качестве моста между DataSet и источником данных для получения и сохранения данных.The DataAdapter serves as a bridge between a DataSet and a data source for retrieving and saving data. DataAdapter предоставляет этот мост путем сопоставления Fill, который изменяет данные в DataSet в соответствии с данными в источнике данных, а также Update, что приводит к изменению данных в источнике данных в соответствии с данными в DataSet.The DataAdapter provides this bridge by mapping Fill, which changes the data in the DataSet to match the data in the data source, and Update, which changes the data in the data source to match the data in the DataSet.

При подключении к базе данных SQL Server можно повысить общую производительность, используя SqlDataAdapter вместе со связанными SqlCommand и SqlConnection объектами.If you are connecting to a SQL Server database, you can increase overall performance by using the SqlDataAdapter along with its associated SqlCommand and SqlConnection objects. Для источников данных, поддерживаемых OLE DB, используйте DataAdapter со связанными объектами OleDbCommand и OleDbConnection.For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. Для источников данных, поддерживаемых ODBC, используйте DataAdapter со связанными объектами OdbcCommand и OdbcConnection.For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. Для баз данных Oracle используйте DataAdapter со связанными объектами OracleCommand и OracleConnection.For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

При создании экземпляра DataAdapter свойства чтения и записи устанавливаются в начальные значения.When an instance of DataAdapter is created, the read/write properties are set to initial values. Список этих значений см. в конструкторе DataAdapter.For a list of these values, see the DataAdapter constructor.

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

DataAdapter()

Инициализирует новый экземпляр класса DataAdapter.Initializes a new instance of a DataAdapter class.

DataAdapter(DataAdapter)

Инициализирует новый экземпляр класса DataAdapter из существующего объекта того же типа.Initializes a new instance of a DataAdapter class from an existing object of the same type.

Свойства

AcceptChangesDuringFill

Возвращает или задает значение, указывающее, вызывается ли метод AcceptChanges() в объекте DataRow после его добавления к объекту DataTable при выполнении любой из операций Fill.Gets or sets a value indicating whether AcceptChanges() is called on a DataRow after it is added to the DataTable during any of the Fill operations.

AcceptChangesDuringUpdate

Возвращает или задает, вызывается ли метод AcceptChanges() при вызове метода Update(DataSet).Gets or sets whether AcceptChanges() is called during a Update(DataSet).

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
ContinueUpdateOnError

Возвращает или задает значение, указывающее, следует ли генерировать ли исключение при обнаружении ошибки во время обновления строки.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
FillLoadOption

Возвращает или задает значение перечисления типа LoadOption, определяющее, как адаптер заполняет объект DataTable из объекта DbDataReader.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

MissingMappingAction

Определяет действие, выполняемое, если входные данные не соответствуют таблице или столбцу.Determines the action to take when incoming data does not have a matching table or column.

MissingSchemaAction

Определяет действие, которое должно быть выполнено, если существующая схема DataSet не соответствует входным данным.Determines the action to take when existing DataSet schema does not match incoming data.

ReturnProviderSpecificTypes

Возвращает или задает, должен ли метод Fill возвращать зависящие от поставщика значения или обычные CLS-совместимые значения.Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
TableMappings

Получает коллекцию, обеспечивающую основное сопоставление между исходной таблицей и DataTable.Gets a collection that provides the master mapping between a source table and a DataTable.

Методы

CloneInternals()

Создает дубликат этого экземпляра класса DataAdapter.Creates a copy of this instance of DataAdapter.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
CreateTableMappings()

Создает новый экземпляр DataTableMappingCollection.Creates a new DataTableMappingCollection.

Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом DataAdapter, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the DataAdapter and optionally releases the managed resources.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Fill(DataSet)

Добавляет или обновляет строки в DataSet для получения соответствия строкам в источнике данных.Adds or refreshes rows in the DataSet to match those in the data source.

Fill(DataSet, String, IDataReader, Int32, Int32)

Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и DataTable.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataTable, IDataReader)

Добавляет или обновляет строки в DataTable для получения соответствия строкам в источнике данных с помощью имени DataTable и указанного интерфейса IDataReader.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

Fill(DataTable[], IDataReader, Int32, Int32)

Добавляет или обновляет строки в указанной коллекции объектов DataTable для получения соответствия строкам в источнике данных.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

FillSchema(DataSet, SchemaType)

Добавляет объект DataTable к указанному объекту DataSet и настраивает схему в соответствии с источником данных, основанном на указанном значении типа SchemaType.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, String, IDataReader)

Добавляет объект DataTable к указанному объекту DataSet.Adds a DataTable to the specified DataSet.

FillSchema(DataTable, SchemaType, IDataReader)

Добавляет объект DataTable к указанному объекту DataSet.Adds a DataTable to the specified DataSet.

GetFillParameters()

Получает параметры, заданные пользователем при выполнении оператора SQL SELECT.Gets the parameters set by the user when executing an SQL SELECT statement.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HasTableMappings()

Указывает, был ли создан DataTableMappingCollection.Indicates whether a DataTableMappingCollection has been created.

InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Вызывается при возникновении ошибки, когда применяется метод Fill.Invoked when an error occurs during a Fill.

ResetFillLoadOption()

Сбрасывает свойство FillLoadOption к состоянию по умолчанию и вызывает метод Fill(DataSet) для обеспечения поддержки свойства AcceptChangesDuringFill.Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

ShouldSerializeAcceptChangesDuringFill()

Определяет, должно ли сохраняться свойство AcceptChangesDuringFill.Determines whether the AcceptChangesDuringFill property should be persisted.

ShouldSerializeFillLoadOption()

Определяет, должно ли сохраняться свойство FillLoadOption.Determines whether the FillLoadOption property should be persisted.

ShouldSerializeTableMappings()

Определяет, существует ли один или несколько объектов DataTableMapping и нужно ли их сохранить.Determines whether one or more DataTableMapping objects exist and they should be persisted.

ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Унаследовано от Component)
Update(DataSet)

Вызывает соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном объекте DataSet из DataTable с именем "Table".Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table."

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)
FillError

Возвращается при возникновении ошибки во время работы операции заполнения.Returned when an error occurs during a fill operation.

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

IDataAdapter.TableMappings

Указывает, как исходная таблица сопоставлена с таблицей набора данных.Indicates how a source table is mapped to a dataset table.

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

Дополнительно