IDataAdapter Интерфейс

Определение

Пространство имен:
System.Data
Сборки:
netstandard.dll, System.Data.Common.dll
Сборка:
System.Data.Common.dll
Сборка:
System.Data.dll
Сборка:
netstandard.dll
Исходный код:
IDataAdapter.cs
Исходный код:
IDataAdapter.cs
Исходный код:
ExpressionNode.cs

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

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

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

Примеры

В следующем примере используются производные классы, 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 "Таблица".
FillSchema(DataSet, SchemaType)

DataTable Добавляет имя "Таблица" в указанный DataSet и настраивает схему для сопоставления в источнике данных на основе указанногоSchemaType.
GetFillParameters()

Возвращает параметры, заданные пользователем при выполнении инструкции SQL SELECT.
Update(DataSet)

Вызывает соответствующие инструкции INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанной DataSet строке с DataTable именем Table.

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