IDataAdapter Интерфейс

Определение

Позволяет объекту реализовать DataAdapter и представляет набор методов и соответствующие свойства, связанные с операциями, для заполнения и обновления объекта DataSet и обновления источника данных.Allows an object to implement a DataAdapter, and represents a set of methods and mapping action-related properties that are used to fill and update a DataSet and update a data source.

Экземпляры IDbDataAdapter — для источников данных, которые являются или напоминают реляционные базы данных с текстуальными командами (например, Transact-SQL), а экземпляры IDataAdapter могут использовать любой тип источника данных.IDbDataAdapter instances are for data sources that are (or resemble) relational databases with textual commands (like Transact-SQL), while IDataAdapter instances could can use any type of data source.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Производный

Примеры

В следующем примере SqlCommand SqlDataAdapter SqlConnection для выбора записей из базы данных используются производные классы,, и.The following example uses the derived classes, SqlCommand, SqlDataAdapter, and SqlConnection, to select records from a database. DataSetЗатем возвращается заполненный.The filled DataSet is then returned. Для этого методу передается инициализированный DataSet , строка подключения и строка запроса, которая является инструкцией Transact-SQL SELECT.To do 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

Комментарии

IDataAdapterИнтерфейс позволяет наследующему классу реализовать класс DataAdapter, который представляет мост между источником данных и DataSet .The IDataAdapter interface allows 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.

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

Классы, наследующие, IDataAdapter должны реализовывать наследуемые члены и обычно определяют дополнительные члены для добавления функций, зависящих от поставщика.Classes that inherit IDataAdapter must implement the inherited members, and they typically define additional members to add provider-specific functionality. Например, IDataAdapter интерфейс определяет Fill метод, принимающий в DataSet качестве параметра.For example, the IDataAdapter interface defines a Fill method that takes a DataSet as a parameter. В свою очередь OleDbDataAdapter класс наследует метод, Fill а также определяет две дополнительные перегрузки Fill метода, которые принимают объект набора записей ADO в качестве параметра.In turn, the OleDbDataAdapter class inherits 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.

При наследовании от IDataAdapter интерфейса необходимо реализовать следующие конструкторы:When you inherit from the IDataAdapter 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 by using the specified SQL SELECT statement.
Првдатаадаптер (строка Селекткоммандтекст, строка Селектконнектионстринг)PrvDataAdapter(string selectCommandText, string selectConnectionString) Инициализирует новый экземпляр класса Првдатаадаптер, используя инструкцию SQL SELECT и строку подключения.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a connection string.
Првдатаадаптер (строка Селекткоммандтекст, Првконнектион Селектконнектион)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Инициализирует новый экземпляр класса Првдатаадаптер, используя инструкцию SQL SELECT и объект Првконнектион.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a PrvConnection object.

Свойства

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.

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.

TableMappings

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

Методы

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".

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.

GetFillParameters()

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

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".

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