IDbDataAdapter Интерфейс

Определение

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

System.Data

Сборка:

System.Data.Common.dll

Представляет набор связанных с командой свойств, которые используются для заполнения 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

Примеры

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

Комментарии

Интерфейс IDbDataAdapter наследуется от IDataAdapter интерфейса и позволяет объекту создать DataAdapter, предназначенный для использования с реляционной базой данных. Интерфейс IDbDataAdapter и, при необходимости, служебный класс , DbDataAdapterпозволяют наследуемому классу реализовать класс DataAdapter, который представляет мост между источником данных и 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 с именем "Table". (Унаследовано от IDataAdapter)
FillSchema(DataSet, SchemaType)	Добавляет объект DataTable с именем Table в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанного значения типа SchemaType. (Унаследовано от IDataAdapter)
GetFillParameters()	Получает параметры, заданные пользователем при выполнении оператора SQL SELECT. (Унаследовано от IDataAdapter)
Update(DataSet)	Вызывает соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном объекте DataSet из объекта DataTable с именем "Table". (Унаследовано от IDataAdapter)