IDbDataAdapter Интерфейс

Определение

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

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

IDbDataAdapter.cs

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

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Производный

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Реализации

IDataAdapter

Примеры

В следующем примере используются производные классы и SqlCommandSqlDataAdapterSqlConnectionдля выбора записей из источника данных. Затем возвращается заполнение 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

Комментарии

Интерфейс IDbDataAdapter наследует от IDataAdapter интерфейса и позволяет объекту создавать DataAdapter, предназначенный для использования с реляционной базой данных. Интерфейс IDbDataAdapter и, при необходимости, DbDataAdapterслужебный класс, позволяют наследующим классу реализовать класс DataAdapter, который представляет мост между источником данных и a DataSet. Дополнительные сведения о классах DataAdapter см. в разделе "Заполнение набора данных" из DataAdapter. Дополнительные сведения о реализации поставщиков данных .NET Framework см. в разделе "Реализация поставщика данных .NET Framework".

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

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

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

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

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

Пункт	Описание
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.

Свойства

Имя	Описание
DeleteCommand	Возвращает или задает инструкцию SQL для удаления записей из набора данных.
InsertCommand	Возвращает или задает инструкцию SQL, используемую для вставки новых записей в источник данных.
MissingMappingAction	Указывает или указывает, передаются ли несопоставленные исходные таблицы или столбцы с именами источников для фильтрации или возникновения ошибки. (Унаследовано от IDataAdapter)
MissingSchemaAction	Указывает или указывает, добавляются ли отсутствующие исходные таблицы, столбцы и их связи в схему набора данных, игнорируются или возникают ошибки. (Унаследовано от IDataAdapter)
SelectCommand	Возвращает или задает инструкцию SQL, используемую для выбора записей в источнике данных.
TableMappings	Возвращает коллекцию, показывающую, как исходная таблица сопоставляется с таблицей набора данных. (Унаследовано от IDataAdapter)
UpdateCommand	Возвращает или задает инструкцию SQL, используемую для обновления записей в источнике данных.

Методы

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