SqlCeDataAdapter Class

Artigo
01/14/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

public sealed class SqlCeDataAdapter : DbDataAdapter, ICloneable

public ref class SqlCeDataAdapter sealed : public DbDataAdapter, ICloneable

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

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.

Hierarquia de herança

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DataAdapter
         System.Data.Common.DbDataAdapter
          System.Data.SqlServerCe.SqlCeDataAdapter

Exemplo

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();
}

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeDataAdapter Members
System.Data.SqlServerCe Namespace
SqlCeConnection Class
SqlCeCommand Class
DataSet
DataTable

Compartilhar via