Criando aplicativos da área de trabalho (SQL Server Compact)

Você pode usar o SQL Server Compact como repositório de dados para aplicativos de computador. Neste tópico, você aprenderá como adicionar o SQL Server Compact a um produto Visual Studio e, em seguida, no namespace System.Data.SqlServerCe. Tópicos gerenciados de referência do namespace System.Data.SqlServerCe estão disponíveis na documentação de referência do .NET Framework.

Criando um projeto de computador

Para criar um novo aplicativo de computador, crie primeiro um projeto do Windows no Visual Studio. Para um aplicativo de computador, é necessário adicionar em seguida uma referência ao namespace Microsoft.Ink.

Para criar um projeto de computador

1. No Visual Studio, no menu Arquivo, aponte para Novo e selecione Projeto.

2. Na lista Modelos Instalados da caixa de diálogo Novo Projeto, expanda a linguagem de programação a ser usada e selecione Windows.

3. Na lista Modelos, selecione Aplicativo Windows Forms.

4. Forneça um nome e um local para seu projeto e, em seguida, clique em OK.

   O Visual Studio cria um novo projeto e exibe o formulário principal (Form1).

5. (Opcional) No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência.

   Dica

   Se a pasta Referências não estiver listada no Gerenciador de Soluções, clique em Mostrar Todos os Arquivos na parte superior do Gerenciador de Soluções.

6. (Opcional) Na lista de assemblies do .NET, selecione Microsoft Tablet PC API e clique em OK.

   Agora a lista de referências inclui Microsoft.Ink.

Acrescentando o SQL Server Compact 4.0 ao projeto ao criar implantação central

Depois de criar o projeto, adicione uma referência ao assembly SQL Server Compact. Os procedimentos para acrescentar referências aos assemblies SQL Server Compact quando você cria um aplicativo para implantação particular ou para implantação central do SQL Server Compact são ligeiramente diferentes. Siga estas etapas para a implantação central.

Para adicionar uma referência ao SQL Server Compact 4.0 para implantação central

1. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência.

   Dica

   Se a pasta Referências não estiver listada no Gerenciador de Soluções, clique em Mostrar Todos os Arquivos na parte superior do Gerenciador de Soluções.

2. Na lista de assemblies do .NET, selecione System.Data.SqlServerCe e clique em OK. Se System.Data.SqlServerCe não estiver listado, execute estas etapas:

   1. Na caixa de diálogo Adicionar Referências, clique em Procurar.

   2. Navegue até a seguinte pasta: %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Desktop.

   3. Selecione System.Data.SqlServerCe.dll e clique em OK.

   Agora, a lista de referências do Gerenciador de Soluções inclui o System.Data.SqlServerCe, e esse assembly pode ser usado no seu projeto.

   Dica

   Se seu projeto usar o Estrutura da entidade, repita as mesmas etapas para acrescentar uma referência a System.Data.SqlServerCe.Entity. Você pode adicionar System.Data.SqlServerCe.Entity da lista de assemblies .NET ou pode navegar até %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0.

3. No Gerenciador de Soluções, clique com o botão direito do mouse em Form1.cs ou em Form1.vb e selecione Exibir Código.

4. Na parte superior do código do formulário, adicione uma diretiva para usar o namespace System.Data.SqlServerCe. Se você usa o Estrutura da entidade, acrescente uma diretiva para usar o namespace System.Data.SqlServerCe. Para um aplicativo do Tablet PC, adicione também uma diretiva para usar a API Tablet PC:

   • C#

     using System.Data.SqlServerCe;
     using System.Data.SqlServerCe.Entity; 
     using Microsoft.Ink;
     

   • Visual Basic

     Imports System.Data.SqlServerCe
     Imports System.Data.SqlServerCe.Entity
     Imports Microsoft.Ink
     

Acrescentando o SQL Server Compact 4.0 ao projeto ao criar a implantação particular

Depois de criar o projeto, adicione uma referência ao assembly SQL Server Compact. Os procedimentos para acrescentar referências aos assemblies SQL Server Compact quando você cria um aplicativo para implantação particular ou para implantação central do SQL Server Compact são ligeiramente diferentes. Siga estas etapas para a implantação particular.

Para adicionar uma referência ao SQL Server Compact 4.0 para implantação central

1. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência.

   Dica

   Se a pasta Referências não estiver listada no Gerenciador de Soluções, clique em Mostrar Todos os Arquivos na parte superior do Gerenciador de Soluções.

2. Na caixa de diálogo Adicionar Referências, clique em Procurar.

3. Navegue até a pasta %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private.

4. Selecione System.Data.SqlServerCe e clique em OK.

   Agora, a lista de referências do Gerenciador de Soluções inclui o System.Data.SqlServerCe, e esse assembly pode ser usado no seu projeto.

   Dica

   Se seu projeto usar o Estrutura da entidade, repita as mesmas etapas para acrescentar uma referência a System.Data.SqlServerCe.Entity. (Para implantação particular, o System.Data.SqlServerCe.Entity também é adicionado da pasta %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private.)

5. No Gerenciador de Soluções, clique com o botão direito do mouse em Form1.cs ou em Form1.vb e selecione Exibir Código.

6. Na parte superior do código do formulário, adicione uma diretiva para usar o namespace System.Data.SqlServerCe. Se você usa o Estrutura da entidade, acrescente uma diretiva para usar o namespace System.Data.SqlServerCe. Para um aplicativo do Tablet PC, adicione também uma diretiva para usar a API Tablet PC:

   • C#

     using System.Data.SqlServerCe;
     using System.Data.SqlServerCe.Entity; 
     using Microsoft.Ink;
     

   • Visual Basic

     Imports System.Data.SqlServerCe
     Imports System.Data.SqlServerCe.Entity
     Imports Microsoft.Ink
     

Configurando o SQL Server Compact para a implantação particular

Para criar um aplicativo que usa a implantação particular para o SQL Server Compact, verifique se o provedor de dados .NET Framework e qualquer DLL nativa necessária estão implantados no diretório de saída do aplicativo. Caso deseje que seu aplicativo utilize a implantação particular para SQL Server Compact, siga as etapas desta seção. Se seu aplicativo não usar a implantação particular, ignore esta seção. Para obter mais informações sobre a implantação particular do SQL Server Compact, consulte Implantação privada vs. implantação central (SQL Server Compact). As etapas a seguir supõem que o aplicativo está sendo criado com qualquer plataforma como destino (de 32 bits e de 64 bits). Se seu aplicativo tiver apenas uma dessas plataformas como destino, você poderá omitir as etapas que se aplicam à outra plataforma.

Para configurar o aplicativo para a implantação particular do SQL Server Compact

1. Configure o provedor de dados .NET Framework para o assembly SQL Server Compact a ser copiado no diretório de saída quando o projeto for criado.

   1. Em Gerenciador de Soluções, expanda Referências, clique com o botão direito do mouse em System.Data.SqlServerCe e selecione Propriedades.

   2. Em Propriedades de Referência do System.Data.SqlServerCe, defina Copiar Local como True.

   Dica

   Se o projeto usar o Estrutura da entidade, repita as mesmas etapas para System.Data.SqlServerCe.Entity para configurar o provedor de dados Estrutura da entidade para o SQL Server Compact a ser copiado no diretório de saída.

2. Acrescente as bibliotecas nativas SQL Server Compact necessárias de 32 bits ao projeto.

   1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto, aponte para Adicionar e selecione Nova Pasta. Coloque o nome x86 na pasta.

   2. No Gerenciador de Soluções, clique com o botão direito do mouse na pasta x86, aponte para Adicionar e selecione Item Existente.

   3. Na caixa de diálogo Adicionar Item Existente, navegue até a pasta na qual as bibliotecas nativas de 32 bits estão localizadas. Em uma versão Windows de 32 bits, a pasta é %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0. Em uma versão Windows de 64 bits, a pasta é %Arquivos de Programas (x86)%\Microsoft SQL Server Compact Edition\v4.0.

   4. Clique e pressione a tecla Control em cada uma das bibliotecas nativas necessárias em seu projeto para selecioná-las na lista de arquivos e depois clique em OK. As bibliotecas são acrescentadas à pasta x86.

      Dica

      Acrescente no mínimo as seguintes bibliotecas: sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll e sqlceer40.dll.

3. Acrescente as bibliotecas nativas SQL Server Compact necessárias de 64 bits ao projeto.

   1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto, aponte para Adicionar e selecione Nova Pasta. Coloque o nome x64 na pasta.

   2. No Gerenciador de Soluções, clique com o botão direito do mouse na pasta x64, aponte para Adicionar e selecione Item Existente.

   3. Na caixa de diálogo Adicionar Item Existente, navegue até a pasta na qual as bibliotecas nativas de 64 bits estão localizadas. Em uma versão Windows de 64 bits, a pasta é %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0.

      Dica

      Você não pode instalar a versão de 64 bits do SQL Server Compact em um computador que está executando uma versão Windows de 32 bits. Primeiro extraia os arquivos do instalador de 64 bits em um diretório no computador de desenvolvimento para acrescentar as bibliotecas nativas de 64 bits a um ser de projeto criado em um ambiente de desenvolvimento de 32 bits. Depois, você pode navegar até esse diretório para acrescentar as bibliotecas nativas de 64 bits a seu projeto. Para obter mais informações sobre como extrair arquivos do instalador, consulte Como extrair DLLs de 64 bits do instalador em tempo de execução do SQL Server Compact.

   4. Clique e pressione a tecla Control em cada uma das bibliotecas nativas necessárias em seu projeto para selecioná-las na lista de arquivos e depois clique em OK. As bibliotecas são acrescentadas à pasta x64.

      Dica

      Acrescente no mínimo as seguintes bibliotecas: sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll e sqlceer40.dll.

4. Configure cada biblioteca nativa adicionada nas etapas anteriores a ser copiada no diretório de saída quando o projeto é criado. Você deve fazer isso para as bibliotecas em ambos os diretórios.

   1. Em Gerenciador de Soluções, clique com o botão direito do mouse na biblioteca (por exemplo, sqlcese40.dll) e selecione propriedades.

      Dica

      Se os assemblies não estiverem listados em Gerenciador de Soluções, clique em Mostrar Todos os Arquivos na parte superior de Gerenciador de Soluções.

   2. Em Propriedades do arquivo, selecione Copiar Sempre ou Copiar se Mais Novo na lista suspensa Copiar em Diretório de Saída.

5. Configure o projeto para criar Qualquer CPU.

   1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Propriedades para abrir o Designer de Projeto.

   2. Clique em Criar e selecione Qualquer CPU da lista suspensa Destino da Plataforma.

Usando os objetos do SQL Server Compact 4.0

Depois que o namespace System.Data.SqlServerCe foi adicionado, você pode começar a codificar com relação a ele usando os objetos do SQL Server Compact. O exemplo de código a seguir mostra como usar o objeto Engine para criar um novo arquivo de banco de dados do SQL Server Compact.

using System;
using System.Data.SqlServerCe;
using System.IO;

public class MySqlCeEngine
{
    public void CreateDB()
    {
        File.Delete("Test.sdf");
        string connString = "Data Source='Test.sdf'; LCID=1033;   Password=<enterStrongPasswordHere>; Encrypt = TRUE;";
        SqlCeEngine engine = new SqlCeEngine(connString);
        engine.CreateDatabase();
    }
}

Imports System
Imports System.Data.SqlServerCe
Imports System.IO

Public Class MySqlCeEngine

    Public Sub CreateDB()
        File.Delete("Test.sdf")
        Dim connString As String = "Data Source='Test.sdf'; LCID=1033; Password=<enterStrongPasswordHere>; Encrypt = TRUE;"
        Dim engine As New SqlCeEngine(connString)
        engine.CreateDatabase()
    End Sub
End Class 

Consulte também

Referência

Namespace System.Data.SqlServerCe (documentação de referência do .NET Framework)