IDataAdapter Interface

Definição

Namespace:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Permite que um objeto implemente um DataAdapter e represente um conjunto de métodos e propriedades relacionadas à ação de mapeamento que são usadas para preencher e atualizar uma DataSet fonte de dados e atualizar.

IDbDataAdapter instâncias são para fontes de dados que são (ou se assemelham) bancos de dados relacionais com comandos textuais (como Transact-SQL), enquanto instâncias IDataAdapter podem usar qualquer tipo de fonte de dados.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Derivado

Exemplos

O exemplo a seguir usa as classes derivadas, SqlCommande SqlDataAdapterSqlConnection, para selecionar registros de um banco de dados. Em seguida, o preenchimento DataSet é retornado. Para fazer isso, o método é passado um DataSet inicializado, um cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução 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

Comentários

A IDataAdapter interface permite que uma classe herdada implemente uma classe DataAdapter, que representa a ponte entre uma fonte de dados e uma DataSet. Para obter mais informações sobre classes DataAdapter, consulte Populando um DataSet de um DataAdapter.

Um aplicativo não cria uma instância da IDataAdapter interface diretamente, mas implementa uma instância de uma classe que herda IDataAdapter.

As classes herdadas IDataAdapter devem implementar os membros herdados e normalmente definem membros adicionais para adicionar funcionalidade específica do provedor. Por exemplo, a IDataAdapter interface define um Fill método que usa um DataSet parâmetro como um parâmetro. Por sua vez, a OleDbDataAdapter classe herda o Fill método e também define duas sobrecargas adicionais do Fill método que tomam um objeto ADO Recordset como um parâmetro.

Notas aos Implementadores

Para promover a consistência entre os provedores de dados do .NET Framework, nomeie a classe herdada no formulário Prv DataAdapter em que Prv é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace.

Ao herdar da IDataAdapter interface, você deve implementar os seguintes construtores:

Item Descrição
PrvDataAdapter() Inicializa uma nova instância da classe PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand) Inicializa uma nova instância da classe PrvDataAdapter usando a instrução SQL SELECT especificada.
PrvDataAdapter(string selectCommandText, string selectConnectionString) Inicializa uma nova instância da classe PrvDataAdapter usando uma instrução SQL SELECT e um cadeia de conexão.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inicializa uma nova instância da classe PrvDataAdapter usando uma instrução SQL SELECT e um objeto PrvConnection.

Propriedades

Nome Description
MissingMappingAction

Indica ou especifica se as tabelas ou colunas de origem não mapeadas são passadas com seus nomes de origem para serem filtradas ou gerar um erro.
MissingSchemaAction

Indica ou especifica se tabelas de origem, colunas e suas relações ausentes são adicionadas ao esquema do conjunto de dados, ignoradas ou fazem com que um erro seja gerado.
TableMappings

Obtém uma coleção que indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados.

Métodos

Nome Description
Fill(DataSet)

Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados usando o DataSet nome e cria uma DataTable "Tabela".
FillSchema(DataSet, SchemaType)

Adiciona uma DataTable "Tabela" nomeada ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base na especificada SchemaType.
GetFillParameters()

Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT.
Update(DataSet)

Chama as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no especificado DataSet de uma DataTable "Tabela".

Aplica-se a