IDataAdapter Interface

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Permite que um objeto implemente um DataAdapter e representa um conjunto de métodos e propriedades relacionadas com ações de mapeamento que são usados para preencher e atualizar uma DataSet fonte de dados.

são para fontes de dados que são (ou se assemelham) a bases de dados relacionais com comandos textuais (como Transact-SQL), enquanto instâncias 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 seguinte utiliza as classes derivadas, SqlCommand, SqlDataAdapter, e SqlConnection, para selecionar registos de uma base de dados. O preenchimento DataSet é então devolvido. Para isso, o método recebe uma DataSet inicializada, uma cadeia de ligação e uma cadeia 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

Observações

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

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

As classes que herdam IDataAdapter devem implementar os membros herdados, e normalmente definem membros adicionais para adicionar funcionalidades específicas ao fornecedor. Por exemplo, a IDataAdapter interface define um Fill método que toma a DataSet como 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 aceitam um objeto ADO Recordet como parâmetro.

Notas para Implementadores

Para promover a consistência entre .NET fornecedores de dados do Framework, nomeie a classe herdadora na forma Prv DataAdapter, onde Prv é o prefixo uniforme dado a todas as classes num determinado espaço de dados do fornecedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace.

Quando herdas da IDataAdapter interface, deves implementar os seguintes construtores:

Número 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 uma cadeia de ligaçã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

Name Description
MissingMappingAction

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

Indica ou especifica se tabelas fonte, colunas e as suas relações em falta são adicionadas ao esquema do conjunto de dados, ignoradas ou causam o surgimento de um erro.
TableMappings

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

Métodos

Name Description
Fill(DataSet)

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

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

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

Chama as respetivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou eliminada na especificada DataSet a partir de uma DataTable "Tabela" nomeada.

Aplica-se a