IDataAdapter Интерфейс

Определение

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

System.Data

Сборка:

System.Data.Common.dll

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

Экземпляры IDbDataAdapter — для источников данных, которые являются или напоминают реляционные базы данных с текстуальными командами (например, Transact-SQL), а экземпляры IDataAdapter могут использовать любой тип источника данных.

public interface class IDataAdapter

public interface IDataAdapter

type IDataAdapter = interface

Public Interface IDataAdapter

Производный

System.Data.Common.DataAdapter

System.Data.Common.DbDataAdapter

System.Data.IDbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Примеры

В следующем примере для выбора записей из базы данных используются производные классы SqlCommand, SqlDataAdapterи SqlConnection. Затем возвращается заполненное DataSet . Для этого методу передаются инициализированные DataSet, строка подключения и строка запроса, которая является инструкцией SELECT Transact-SQL.

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. Дополнительные сведения о классах DataAdapter см. в разделе Заполнение набора данных из DataAdapter.

Приложение не создает экземпляр IDataAdapter интерфейса напрямую, но реализует экземпляр класса, наследующего IDataAdapter.

Наследуемые IDataAdapter классы должны реализовывать наследуемые члены и обычно определяют дополнительные члены для добавления функций, зависящих от поставщика. Например, IDataAdapter интерфейс определяет Fill метод, который принимает в DataSet качестве параметра . В свою очередь, OleDbDataAdapter класс наследует Fill метод , а также определяет две дополнительные перегрузки Fill метода, которые принимают объект ADO Recordset в качестве параметра.

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

Чтобы повысить согласованность между поставщиками данных платформа .NET Framework, наследующий класс назовите в форме Prv DataAdapter, где Prv — это универсальный префикс, заданный всем классам в определенном пространстве имен поставщика данных платформа .NET Framework. Например, Sql является префиксом SqlDataAdapter класса в System.Data.SqlClient пространстве имен .

При наследовании IDataAdapter от интерфейса следует реализовать следующие конструкторы:

Элемент	Описание
PrvDataAdapter()	Инициализирует новый экземпляр класса PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью указанной инструкции SQL SELECT.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и строка подключения.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Инициализирует новый экземпляр класса PrvDataAdapter с помощью инструкции SQL SELECT и объекта PrvConnection.

Свойства

MissingMappingAction	Указывает, будут ли несопоставленные столбцы-источники или таблицы-источники передаваться со своими исходными именами, чтобы пройти через фильтр или вызвать ошибку.
MissingSchemaAction	Указывает или задает значение, определяющее, будут ли отсутствующие исходные таблицы, столбцы и их отношения добавляться в схему набора данных, игнорироваться или вызывать ошибку.
TableMappings	Возвращает коллекцию, указывающую, как исходная таблица сопоставляется с таблицей набора данных.

Методы

Fill(DataSet)	Добавляет или обновляет строки в объект DataSet для получения соответствия со строками в источнике данных, используя имя объекта DataSet и создает объект DataTable с именем "Table".
FillSchema(DataSet, SchemaType)	Добавляет объект DataTable с именем Table в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанного значения типа SchemaType.
GetFillParameters()	Получает параметры, заданные пользователем при выполнении оператора SQL SELECT.
Update(DataSet)	Вызывает соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном объекте DataSet из объекта DataTable с именем "Table".