IDataAdapter Интерфейс

Определение

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

System.Data

Сборка:

System.Data.Common.dll

Сборка:

System.Data.dll

Сборка:

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

Примеры

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

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, который представляет мост между источником данных и a 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".