Classe SqlCeDataAdapter

Artigo
01/17/2011

Representa um conjunto de comandos de dados e uma conexão de banco de dados que são usados para preencher o DataSet e atualizar a fonte de dados.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public NotInheritable Class SqlCeDataAdapter _
    Inherits DbDataAdapter _
    Implements ICloneable
'Uso
Dim instance As SqlCeDataAdapter

public sealed class SqlCeDataAdapter : DbDataAdapter, 
    ICloneable

public ref class SqlCeDataAdapter sealed : public DbDataAdapter, 
    ICloneable

[<SealedAttribute>]
type SqlCeDataAdapter =  
    class
        inherit DbDataAdapter
        interface ICloneable
    end

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

Comentários

O SqlCeDataAdapter atua como uma ponte entre um DataSet e a fonte de dados. Ele é usado para recuperar e salvar dados na fonte de dados. O SqlCeDataAdapter fornece essa ponte usando Fill para carregar dados da fonte de dados no DataSet e usando a Update para enviar as alterações feitas no DataSet de volta à fonte de dados.

Quando o SqlCeDataAdapter preenche um DataSet, as tabelas e colunas necessárias são criadas com os dados retornados, se ainda não existirem. Contudo, as informações da chave primária não serão incluídas no esquema criado implicitamente, a menos que a propriedade MissingSchemaAction seja definida como AddWithKey. Também é possível fazer o SqlCeDataAdapter criar o esquema do DataSet, incluindo informações da chave primária, antes de preenchê-la com dados usando o FillSchema.

O SqlCeDataAdapter inclui as propriedades SelectCommand, InsertCommand, DeleteCommand, UpdateCommand e TableMappings para facilitar o carregamento e a atualização de dados.

Ao criar uma instância do SqlCeDataAdapter, as propriedades são definidas com seus valores iniciais. Para obter uma lista desses valores, consulte o construtor do SqlCeDataAdapter.

Exemplos

O exemplo a seguir usa o SqlCeCommand, o SqlCeDataAdapter e a SqlCeConnection para selecionar registro de uma fonte de dados e preencher um DataSet com as linhas selecionadas. Então, o DataSet preenchido é retornado. Para tanto, um DataSet, uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SQL SELECT são passados para o método.

Try
    Dim strDataSource As String
    strDataSource = "" & _
        "Data Source = C:\Program Files\" & _
        "Microsoft SQL Server Compact Edition\v3.5\Samples\" & _
        "Northwind.sdf"
    Dim conn As New SqlCeConnection
    conn.ConnectionString = strDataSource & ";Password='<password>'"

    Dim selectCmd As SqlCeCommand = conn.CreateCommand
    selectCmd.CommandText = "SELECT * FROM Employees"

    Dim adp As New SqlCeDataAdapter(selectCmd)

    Dim ds As New DataSet

    ' Note: Fill will leave the connection in its original state;
    ' In this case, the connection was closed so it will be left closed
    adp.Fill(ds)

    Console.WriteLine(("The SqlCeDataAdapter succesfully filled " & _
                       ds.Tables.Item(0).Rows.Count & " rows in the DataSet!"))
Catch ds As Exception
    Console.WriteLine(ds.Message)
Finally
    Console.WriteLine(vbNewLine & vbNewLine & vbNewLine & _
                      "Press any key to continue...")
    Console.ReadKey()
End Try

try
{
    string strDataSource =
        @"Data Source = C:\Program Files\" +
        @"Microsoft SQL Server Compact Edition\v3.5\Samples\" +
        @"Northwind.sdf";
    SqlCeConnection conn = new SqlCeConnection();
    conn.ConnectionString = strDataSource + ";Password='<password>'";

    SqlCeCommand selectCmd = conn.CreateCommand();
    selectCmd.CommandText = "SELECT * FROM Employees";

    SqlCeDataAdapter adp = new SqlCeDataAdapter(selectCmd);

    DataSet ds = new DataSet();

    // Note: Fill will leave the connection in its original state;
    // In this case, the connection was closed so it will be left closed
    //
    adp.Fill(ds);

    Console.WriteLine("The SqlCeDataAdapter succesfully filled " +
        ds.Tables[0].Rows.Count + " rows in the DataSet!");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}
finally
{
    Console.WriteLine("\n\n\nPress any key to continue...");
    Console.ReadKey();
}