DbDataAdapter Класс

Определение

Помогает реализации интерфейса IDbDataAdapter.Aids implementation of the IDbDataAdapter interface. Разработчики производных классов DbDataAdapter реализуют набор функций, обеспечивающий строгую типизацию, но наследуют большинство функций, необходимых для полной реализации DataAdapter.Inheritors of DbDataAdapter implement a set of functions to provide strong typing, but inherit most of the functionality needed to fully implement a DataAdapter.

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

Комментарии

Класс наследует DataAdapter от класса и реализует IDbDataAdapter интерфейс. DbDataAdapterThe DbDataAdapter class inherits from the DataAdapter class and implements the IDbDataAdapter interface. Он помогает классу реализовать DataAdapter , предназначенный для использования с реляционной базой данных.It helps a class implement a DataAdapter designed for use with a relational database.

Приложение не создает экземпляр DbDataAdapter класса напрямую, но создает экземпляр класса, наследующего от него.An application does not create an instance of the DbDataAdapter class directly, but creates an instance of a class that inherits from it.

Классы, наследующие DbDataAdapter , должны реализовывать унаследованные члены и, как правило, определяют дополнительные члены для добавления функций, зависящих от поставщика.Classes that inherit DbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Например, DbDataAdapter класс SelectCommand определяет свойство, а DbDataAdapter Fill класс определяет восемь перегрузок метода.For example, the DbDataAdapter class defines the SelectCommand property, and the DbDataAdapter class defines eight overloads of the Fill method. В свою очередь, OleDbDataAdapter класс наследует Fill метод, а также определяет две Fill дополнительные перегрузки, принимающие объект набора записей ADO в качестве параметра.In turn, the OleDbDataAdapter class inherits the Fill method, and also defines two additional overloads of Fill that take an ADO Recordset object as a parameter.

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

При наследовании от DbDataAdapter класса рекомендуется реализовать следующие конструкторы:When you inherit from the DbDataAdapter class, we recommend that you implement the following constructors:

ЭлементItem ОписаниеDescription
*Prv* DataAdapter ()*Prv*DataAdapter() Инициализирует новый экземпляр класса " *Prv*DataAdapter".Initializes a new instance of the *Prv*DataAdapter class.
*Prv* DataAdapter (\*\* команда PRV *SelectCommand*)*Prv*DataAdapter(*Prv*Command *selectCommand*) Инициализирует новый экземпляр класса " *Prv*DataAdapter" с указанной инструкцией SQL SELECT.Initializes a new instance of the *Prv*DataAdapter class with the specified SQL SELECT statement.
*Prv* DataAdapter (строка *селекткоммандтекст*, строка *селектконнектионстринг*)*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Инициализирует новый экземпляр класса " *Prv*DataAdapter" с помощью инструкции SQL SELECT и строки подключения.Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a connection string.
*Prv* DataAdapter (строка *селекткоммандтекст*, *Prv*Connection *селектконнектион*)*Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) Инициализирует новый экземпляр класса " *Prv*DataAdapter" с помощью инструкции SQL SELECT и объекта соединения *Prv*.Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a *Prv*Connection object.

Чтобы обеспечить согласованность между .NET Framework поставщиками данных, следует присвоить классу наследуемого класса в форме PrvDataAdapter, где Prv — универсальный префикс, присвоенный всем классам в определенном пространстве имен поставщика данных .NET Framework.To promote consistency among .NET Framework data providers, you should name the inheriting class in the form PrvDataAdapter, where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Например, "SQL" — это префикс SqlDataAdapter класса в пространстве имен System. Data. SqlClient .For example, "Sql" is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

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

DbDataAdapter()

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

DbDataAdapter(DbDataAdapter)

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

Поля

DefaultSourceTableName

Имя по умолчанию, используемое объектом DataAdapter для сопоставлений таблиц.The default name used by the DataAdapter object for table mappings.

Свойства

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.

(Унаследовано от DataAdapter)
AcceptChangesDuringUpdate

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

(Унаследовано от DataAdapter)
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.

(Унаследовано от DataAdapter)
DeleteCommand

Возвращает или задает команду для удаления записей из набора данных.Gets or sets a command for deleting records from the data set.

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)
FillCommandBehavior

Возвращает или задает реакцию команды, использованной для заполнения адаптера данных.Gets or sets the behavior of the command used to fill the data adapter.

FillLoadOption

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

(Унаследовано от DataAdapter)
InsertCommand

Возвращает или задает команду SQL для вставки новых записей в источник данных.Gets or sets a command used to insert new records into the data source.

MissingMappingAction

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

(Унаследовано от DataAdapter)
MissingSchemaAction

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

(Унаследовано от DataAdapter)
ReturnProviderSpecificTypes

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

(Унаследовано от DataAdapter)
SelectCommand

Возвращает или задает команду, используемую для выбора записей в источнике данных.Gets or sets a command used to select records in the data source.

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.

(Унаследовано от DataAdapter)
UpdateBatchSize

Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые могут выполняться в рамках одного пакета.Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

UpdateCommand

Возвращает или задает команду, используемую для обновления записей в источнике данных.Gets or sets a command used to update records in the data source.

Методы

AddToBatch(IDbCommand)

Добавляет интерфейс IDbCommand к текущему пакету.Adds a IDbCommand to the current batch.

ClearBatch()

Удаляет все объекты IDbCommand из пакета.Removes all IDbCommand objects from the batch.

CloneInternals()

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

(Унаследовано от 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)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

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

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

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

CreateTableMappings()

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

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

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

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

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

Equals(Object)

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

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

Выполняет текущий пакет.Executes the current batch.

Fill(DataSet)

Добавляет или обновляет строки в объекте DataSet.Adds or refreshes rows in the DataSet.

Fill(DataSet, Int32, Int32, String)

Добавляет или обновляет строки в указанном диапазоне в объект 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(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

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

Fill(DataSet, String)

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

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

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

Fill(DataTable)

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

Fill(DataTable, IDataReader)

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

Fill(DataTable, IDbCommand, CommandBehavior)

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

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.

(Унаследовано от DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

Добавляет или обновляет строки в указанном диапазоне в объект 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(Int32, Int32, DataTable[])

Добавляет или обновляет строки в объекте DataTable для получения соответствия строкам в источнике данных, начиная с указанной записи и вплоть до заданного максимального количества получаемых записей.Adds or refreshes rows in a DataTable to match those in the data source starting at the specified record and retrieving up to the specified maximum number of records.

FillSchema(DataSet, SchemaType)

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

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Добавляет объект 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)

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

FillSchema(DataSet, SchemaType, String, IDataReader)

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

(Унаследовано от DataAdapter)
FillSchema(DataTable, SchemaType)

Настраивает схему для указанного объекта DataTable, основываясь на указанном значении типа SchemaType.Configures the schema of the specified DataTable based on the specified SchemaType.

FillSchema(DataTable, SchemaType, IDataReader)

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

(Унаследовано от DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Настраивает схему для указанного объекта DataTable, основываясь на указанном значении типа SchemaType, командной строке и значениях типа CommandBehavior.Configures the schema of the specified DataTable based on the specified SchemaType, command string, and CommandBehavior values.

GetBatchedParameter(Int32, Int32)

Возвращает интерфейс IDataParameter из одной из команд в текущем пакете.Returns a IDataParameter from one of the commands in the current batch.

GetBatchedRecordsAffected(Int32, Int32, Exception)

Возвращает сведения об отдельной попытке обновления в рамках большего по своему объему пакета обновления.Returns information about an individual update attempt within a larger batched update.

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.

(Унаследовано от DataAdapter)
InitializeBatching()

Инициализирует пакетную обработку для объекта DbDataAdapter.Initializes batching for the DbDataAdapter.

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)

Вызывает событие FillError.Raises the FillError event.

OnRowUpdated(RowUpdatedEventArgs)

Вызывает событие RowUpdated поставщика данных .NET Framework.Raises the RowUpdated event of a .NET Framework data provider.

OnRowUpdating(RowUpdatingEventArgs)

Вызывает событие RowUpdating поставщика данных .NET Framework.Raises the RowUpdating event of a .NET Framework data provider.

ResetFillLoadOption()

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

(Унаследовано от DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

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

(Унаследовано от DataAdapter)
ShouldSerializeFillLoadOption()

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

(Унаследовано от DataAdapter)
ShouldSerializeTableMappings()

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

(Унаследовано от DataAdapter)
TerminateBatching()

Завершает пакетную обработку для объекта DbDataAdapter.Ends batching for the DbDataAdapter.

ToString()

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

(Унаследовано от Component)
Update(DataRow[])

Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве объектов DataSet.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array in the DataSet.

Update(DataRow[], DataTableMapping)

Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве объектов DataSet.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array of DataSet objects.

Update(DataSet)

Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном DataSet.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet.

Update(DataSet, String)

Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в DataSet с заданным именем DataTable.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the DataSet with the specified DataTable name.

Update(DataTable)

Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном DataTable.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataTable.

События

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.

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

ICloneable.Clone()

Создает новый объект, являющийся копией текущего экземпляра.Creates a new object that is a copy of the current instance.

IDataAdapter.TableMappings

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

(Унаследовано от DataAdapter)
IDbDataAdapter.DeleteCommand

Возвращает или задает оператор SQL для удаления записей из набора данных.Gets or sets an SQL statement for deleting records from the data set.

IDbDataAdapter.InsertCommand

Возвращает или задает оператор SQL для вставки новых записей в источник данных.Gets or sets an SQL statement used to insert new records into the data source.

IDbDataAdapter.SelectCommand

Возвращает или задает оператор SQL для выбора записей в источнике данных.Gets or sets an SQL statement used to select records in the data source.

IDbDataAdapter.UpdateCommand

Возвращает или задает оператор SQL для обновления записей в источнике данных.Gets or sets an SQL statement used to update records in the data source.

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

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