IDbDataAdapter Интерфейс

Определение

Представляет набор связанных с командой свойств, которые используются для заполнения DataSet и обновления источника данных. Этот набор реализуется с помощью поставщиков данных .NET, у которых есть доступ к реляционным базам данных.Represents a set of command-related properties that are used to fill the DataSet and update a data source, and is implemented by .NET data providers that access relational databases.

public interface class IDbDataAdapter : System::Data::IDataAdapter
public interface IDbDataAdapter : System.Data.IDataAdapter
type IDbDataAdapter = interface
    interface IDataAdapter
Public Interface IDbDataAdapter
Implements IDataAdapter
Производный
Реализации

Примеры

В следующем примере SqlCommand SqlDataAdapter SqlConnection для выбора записей из источника данных используются производные классы, и.The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. DataSetЗатем возвращается заполненный.The filled DataSet is then returned. Для этого методу передается инициализированный DataSet , строка подключения и строка запроса, которая является инструкцией Transact-SQL SELECT.To accomplish this, the method is passed an initialized DataSet, a connection string, and a query string that is a Transact-SQL SELECT statement.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Комментарии

IDbDataAdapterИнтерфейс наследуется от IDataAdapter интерфейса и позволяет объекту создать DataAdapter, предназначенный для использования с реляционной базой данных.The IDbDataAdapter interface inherits from the IDataAdapter interface and allows an object to create a DataAdapter designed for use with a relational database. IDbDataAdapterИнтерфейс и, по желанию, класс Utility, DbDataAdapter позволяют наследующему классу реализовать класс DataAdapter, который представляет мост между источником данных и DataSet .The IDbDataAdapter interface and, optionally, the utility class, DbDataAdapter, allow an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. Дополнительные сведения о классах DataAdapter см. в разделе Заполнение набора данных из DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter. Дополнительные сведения о реализации .NET Framework поставщиков данных см. в разделе Реализация поставщика данных .NET Framework.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Приложение не создает экземпляр IDbDataAdapter интерфейса напрямую, но создает экземпляр класса, который наследует IDbDataAdapter и DbDataAdapter .An application does not create an instance of the IDbDataAdapter interface directly, but creates an instance of a class that inherits IDbDataAdapter and DbDataAdapter.

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

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

Чтобы повысить согласованность между .NET Framework поставщиками данных, назовите класс-наследник в форме Prv DataAdapter, где Prv — это универсальный префикс, присваиваемый всем классам в определенном пространстве имен поставщика данных .NET Framework.To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv DataAdapter 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.

При наследовании от IDbDataAdapter интерфейса необходимо реализовать следующие конструкторы:When you inherit from the IDbDataAdapter interface, you should implement the following constructors:

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

Свойства

DeleteCommand

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

InsertCommand

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

MissingMappingAction

Указывает, будут ли несопоставленные столбцы-источники или таблицы-источники передаваться со своими исходными именами, чтобы пройти через фильтр или вызвать ошибку.Indicates or specifies whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error.

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

Указывает или задает значение, определяющее, будут ли отсутствующие исходные таблицы, столбцы и их отношения добавляться в схему набора данных, игнорироваться или вызывать ошибку.Indicates or specifies whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised.

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

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

TableMappings

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

(Унаследовано от IDataAdapter)
UpdateCommand

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

Методы

Fill(DataSet)

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

(Унаследовано от IDataAdapter)
FillSchema(DataSet, SchemaType)

Добавляет объект DataTable с именем Table в указанный объект 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.

(Унаследовано от IDataAdapter)
GetFillParameters()

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

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

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

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