Instalando um ambiente de desenvolvimento

  • Artigo

Você pode desenvolver aplicativos que usam o SQL Server Compact 4.0 utilizando o ambiente de desenvolvimento Microsoft Visual Studio 2010 SP1. O Visual Studio é a maneira mais fácil de desenvolver e implantar um aplicativo que usa o SQL Server Compact 4.0.

No Visual Studio, você pode criar um aplicativo gerenciado usando Visual C# ou Visual Basic. Você também pode criar um aplicativo nativo para computadores desktop e dispositivos usando a opção Visual C++ (antes conhecida como Microsoft eMbedded Visual C++ 4.0). O Visual C++ tem suporte em Visual Studio 2010 Service Pack 1.

Dica

  • O Visual Studio 2010 SP1 dá suporte ao desenvolvimento e à implantação de aplicativos do SQL Server Compact 3.5 SP2 e do SQL Server Compact 4.0.

  • Os seguintes designers no sistema de projeto da área de trabalho do Windows (Visual Basic ou Visual C#) não trabalham com o SQL Server Compact 4.0:

    • O Assistente para Configuração de Fonte de Dados é usado para configurar conjuntos de dados.

    • O Assistente para Configuração de Dados de Configuração que é usado para configurar a sincronização de dados e o esquema com SQL Server usando o Sync Framework.

    • O assistente Modelo de Dados de Entidade que é usado para gerar entidades de um banco de dados SQL Server Compact.

  • Não há suporte para Microsoft eMbedded Visual Basic no SQL Server Compact 4.0.

Locais e descrições de arquivos do Visual Studio

A tabela a seguir lista, por local, os arquivos do SQL Server Compact, que são instalados no computador de desenvolvimento quando você utiliza o Visual Studio 2010 Service Pack 1. Por padrão, esses arquivos e pastas são criados em:

  • %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\ para SQL Server Compact 4.0. A instalação abaixo corresponde a sistemas de 32 bits.

Local

Sumário

%Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0

DLLs do SQL Server Compact 4.0 para computadores desktop: sqlcecompact40.dll, sqlceca40.dll, sqlceme40.dll, sqlceoledb40.dll, sqlceqp40.dll e sqlcese40.dll. A DLL de descrições de erros, sqlceer40<lang>.dll, também é instalada na pasta. A DLL de erro para os diferentes idiomas contém um sufixo de duas letras que indica o idioma: EN, FR, etc. A pasta também contém o Leiame, os Termos de Licenciamento e o arquivo Redist_<lang>.txt. A pasta também contém o Provedor Gerenciado do SQL Server Compact 4.0 Entity Framework: System.Data.SqlServerCe.Entity.dll, que é a versão instalada no Cache de Assembly Global (GAC). Use esta versão do provedor de estrutura de entidade ao criar aplicativos de área de trabalho para os quais o SQL Server Compact é implantado centralmente; ou ao criar aplicativos de dispositivo. Começando com o SQL Server Compact 4.0, para aplicativos de área de trabalho que implantam de forma privada o SQL Server Compact, use a versão do provedor em %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private.

(i)%Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Desktop

&

(ii)%Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Desktop\System.Data.SqlServerCe.Entity

(i) Provedor gerenciado do SQL Server Compact 4.0 for Desktop: System.Data.SqlServerCe.dll. A partir do SQL Server Compact 4.0, esta pasta contém a versão do provedor gerenciado a ser usado ao criar aplicativos de área de trabalho que usam a implantação central do SQL Server Compact. Esta é a versão instalada no GAC. Para aplicativos de área de trabalho que implantam de forma privada o SQL Server Compact, use a versão do provedor em %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private.

&

(ii) Provedor gerenciado do SQL Server Compact 4.0 Entity Framework: System.Data.SqlServerCe.Entity.dll.

%Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private

O Provedor Gerenciado do SQL Server Compact 4.0 para Desktop, System.Data.SqlServerCe.dll; e o Provedor Gerenciado do SQL Server Compact 4.0 Entity Framework, System.Data.SqlServerCe.Entity.dll. Esta pasta é apresentada com o SQL Server Compact 4.0. Ela contém a versão desses provedores a ser usada na criação de aplicativos de área de trabalho que usam a implantação privada do SQL Server Compact.

(i) %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Desktop\<lang>

&

(ii) %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Desktop\System.Data.SqlServerCe.Entity\<lang>

&

(iii) %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private\<lang>

(i) Recursos localizados para o provedor gerenciado: System.Data.SqlServerCe.resources.dll

&

(ii) Recursos localizados do SQL Server Compact 4.0 Entity Framework: System.Data.SqlServerCe.Entity.dll.resources.dll

&

(iii) No caso de implantação particular, essa pasta será apresentada com o SQL Server Compact 4.0. Ela contém recursos localizados que devem ser usados ao criar aplicativos da área de trabalho, os quais usam a implantação particular do SQL Server Compact:System.Data.SqlServerCe.Entity.resources.dll, System.Data.SqlServerCe.resources.dll

%Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Include

Arquivos de cabeçalho nativos do SQL Server Compact 4.0 (sqlce_sync.h, sqlce_err.h e sqlce_oledb.h).

%Arquivos de Programas%\ Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages\SQL Server Compact Edition 4.0

Série de pastas que contêm os arquivos do SQL Server Compact 4.0 para implantar o SQL Server Compact 4.0 em computadores desktop usando o recurso ClickOnce do Visual Studio.

%Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Samples

Contém o banco de dados de exemplo, Northwind.sdf. Contém também os bancos de dados de exemplos NorthwindOLEDB e IBuySpy que são instalados pelo MSI de Exemplos do SQL Server Compact 4.0.

A tabela a seguir lista a localização dos binários SQL Server Compact 4.0 necessários para a implantação particular do SQL Server Compact dentro da pasta do aplicativo.

Dica

As pastas e os binários listados a seguir também são instalados na pasta %Arquivos de Programas (x86)%\Microsoft SQL Server Compact Edition\v4.0 quando o SQL Server Compact 4.0 é instalado em um computador de 64 bits.

Local

Sumário

(i) %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private\x86

&

(ii) %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private\x86\Microsoft.VC90.CRT

Todos os arquivos binários nativos abaixo são específicos da instalação X86 e da plataforma de 32 bits.

(i) Os arquivos nesse diretório são: sqlceca40.dll, sqlcecompact40.dll, sqlceer40EN.dll, sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll.

&

(ii) Os arquivos binários da implantação local de CRT são instalados em um nível abaixo. Os arquivos nesse diretório são: Microsoft.VC90.CRT.manifest, msvcr90.dll, Readme_ENU.txt.

(i) %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private\amd64

&

(ii) %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v4.0\Private\amd64\Microsoft.VC90.CRT

Todos os binários nativos abaixo são específicos da instalação amd64 e da plataforma de 64 bits.

(i) Os arquivos nesse diretório são: sqlceca40.dll, sqlcecompact40.dll, sqlceer40EN.dll, sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll.

&

(ii) Os arquivos binários da implantação local de CRT são instalados em um nível abaixo. Os arquivos nesse diretório são: Microsoft.VC90.CRT.manifest, msvcr90.dll, Readme_ENU.txt.

Para obter informações sobre componentes de 64 bits, consulte Gerenciando aplicativos de banco de dados de 64 bits.

Implantação do ClickOnce

O ClickOnce é uma tecnologia de instalação de software com suporte no SQL Server Compact 4.0 para implantar aplicativos gerenciados em computadores desktop. O ClickOnce simplifica a implantação de um aplicativo baseado em Windows para os computadores desktop, provisionando o aplicativo em um servidor Web ou em um compartilhamento de arquivo da rede. Para administradores, a implantação ou atualização de um aplicativo consiste na atualização de arquivos em um servidor. Você não precisa atualizar cada cliente individualmente. O Visual Studio 2010 Service Pack 1 fornece suporte completo para publicar e atualizar aplicativos que foram implantados com o ClickOnce. A implantação do ClickOnce está disponível para projetos criados usando Visual Basic e Visual C#, mas não para Visual C++.

Instalando o SQL Server Compact 4.0 Runtime

Após a instalação do Visual Studio 2010 Service Pack 1, você precisa instalar o SQL Server Compact 4.0. Agora a instalação em tempo de execução será habilitada para o arquivo executável. O comportamento da instalação do SQL Server Compact 4.0 depende do sistema operacional (SO), por isso há duas versões diferentes de executável para as duas arquiteturas: sistema operacional de 32 bits e sistema operacional de 64 bits.

A tabela abaixo mostra o comportamento da instalação do SQL Server Compact 4.0

SQL Server Compact 4.0

Sistema operacional

32 bits

32 bits

Êxito

64 bits

Erro

As combinações que indicam “Erro” exibem os seguintes erros:

  • Quando você tentar instalar o aplicativo SQL Server Compact de 64 bits em um sistema de 32 bits, a mensagem de erro é: “Este pacote de instalação não tem suporte neste tipo de processador. Contate o fornecedor do produto“.

  • Quando você tentar instalar o aplicativo SQL Server Compact de 32 bits em um sistema operacional de 64 bits, a mensagem de erro é: “O pacote de instalação do SQL Server Compact x86 não tem suporte no sistema operacional x64, tente com o pacote de instalação do SQL Server Compact x64”.

Para descobrir qual a arquitetura da sua máquina, consulte Meu PC está executando a versão de 32 bits ou de 64 bits do Windows?

Opções de linha de comando para execução do instalador do SQL Server Compact

O instalador do SQL Server Compact oferece várias opções de linha de comando para instalar e efetuar operações adicionais. Você pode efetuar as seguintes operações:

  • Instalação

  • Extração

  • Exibição

  • Acesso à Ajuda

  • Registro

  • Reparo

Opções de instalação:

Você pode usar os parâmetros de instalação a seguir:

  1. </package | /i> - Instala ou configura o SQL Server Compact Runtime.

  2. /a - Refere-se à instalação administrativa e instala o produto na rede.

  3. /uninstall - Desinstala o produto.

Opções de extração:

  • /x[:<path>] - Extrai o msi no caminho especificado.

Opções de exibição:

  1. /quiet - Modo silencioso, no qual não há interação do usuário.

  2. /passive - Modo passivo e somente a barra de progresso é exibida.

  3. /q[n|b|r|f] – Você pode usar estas opções para configurar o nível de interface do usuário, onde:

    • n - Sem interface do usuário

    • b - Interface do usuário básica

    • r - Interface do usuário reduzida

    • f - Interface do usuário completa

A interface do usuário completa é o nível padrão, caso o nível de interface não seja configurado.

Opções da Ajuda:

  • /help | /? – Exibe as informações da Ajuda no console,

Opções de registro em log:

Você pode usar essas opções para registrar quaisquer mensagens, avisos ou registros de acesso.

  • /l[i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] <Arquivo de log>, onde:

    • i - Mensagens de status

    • w - Avisos não fatais

    • e - Todas as mensagens de erro

    • a - Início das ações

    • r - Registros de ações específicas

    • u - Solicitações do usuário

    • c - Parâmetros iniciais da interface do usuário

    • m - Memória insuficiente ou informações de saída fatal

    • o - Mensagens de espaço em disco insuficiente

    • p - Propriedades do terminal

    • v - Saída detalhada

    • x - Informações adicionais de depuração

    • + - Acrescenta a um arquivo de log existente

    • ! - Libera cada linha para o log

    • - Registra todas as informações, exceto para as opções v e x

    • /log <Arquivo de log> - Equivalente a /l* <Arquivo de log>

Opções de reparo:

Você pode usar as opções de reparo a seguir, no caso de possíveis falhas diferentes.

  • /f[p|e|c|m|s|o|d|a|u|v]: Repara um produto:

    • p - Apenas se houver ausência de arquivos

    • o - Se houver ausência de arquivos ou se houver uma versão anterior instalada (padrão)

    • e - Se houver ausência de arquivos ou se houver uma versão anterior ou igual instalada

    • d - Se houver ausência de arquivos ou se houver uma versão diferente instalada

    • c - Se houver ausência de arquivos ou se a soma de verificação não corresponder ao valor calculado

    • a - Força todos os arquivos a serem reinstalados

    • u - Todas as entradas de registro específicas do usuário solicitadas (padrão)

    • m - Todas as entradas de registro específicas do computador solicitadas (padrão)

    • s - Todos os atalhos existentes (padrão)

    • v - Executa da fonte e refaz o cache do pacote local

Consulte também

Referência

Implantando aplicativos (SQL Server Compact)

Conceitos

Criando aplicativos nativos (SQL Server Compact)

Outros recursos

Criando aplicativos gerenciados (SQL Server Compact)