Condividi tramite

Creazione di applicazioni per computer desktop (SQL Server Compact)

  • Articolo

È possibile utilizzare SQL Server Compact 3.5 come archivio dati per le applicazioni per computer. In questo argomento verrà illustrato come aggiungere SQL Server Compact 3.5 a un prodotto Visual Studio, quindi creare codice per lo spazio dei nomi System.Data.SqlServerCe. Nella documentazione di riferimento di .NET Framework sono disponibili argomenti relativi al riferimento gestito per lo spazio dei nomi System.Data.SqlServerCe.

Creazione di un progetto per computer

Per creare una nuova applicazione per computer, creare in primo luogo un progetto Windows in Visual Studio. Per un'applicazione per computer, aggiungere quindi un riferimento allo spazio dei nomi Microsoft.Ink.

Nota

Se si sviluppa un'applicazione per Tablet PC su un computer che non esegue Windows XP Tablet PC Edition, è in primo luogo necessario installare Microsoft Windows XP Tablet PC Edition Development Kit. È possibile scaricare la versione più recente da Mobile and Embedded Application Developer Center.

Per creare un nuovo progetto per computer

  1. In Visual Studio scegliere Nuovo dal menu File, quindi selezionare Progetto.

  2. Nell'elenco Modelli installati della finestra di dialogo Nuovo progetto espandere il linguaggio di programmazione da utilizzare, quindi selezionare Windows.

  3. Nell'elenco Modelli selezionare Applicazione Windows Form.

  4. Specificare il nome e il percorso del progetto e scegliere OK.

    In Visual Studio verrà creato un nuovo progetto e verrà visualizzato il form principale (Form1).

  5. (Facoltativo) In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento.

    Nota

    Se la cartella Riferimenti non è disponibile in Esplora soluzioni, fare clic su Mostra tutti i file nella parte superiore della finestra di Esplora soluzioni.

  6. (Facoltativo) Nell'elenco degli assembly .NET selezionare Microsoft Tablet PC API e quindi scegliere OK.

    Nell'elenco dei riferimenti verrà incluso Microsoft.Ink.

Aggiunta di SQL Server Compact 3.5 al progetto durante la compilazione per la distribuzione centrale

Dopo aver creato il progetto, è necessario aggiungere un riferimento all'assembly SQL Server Compact 3.5. Le procedure per l'aggiunta di riferimenti agli assembly SQL Server Compact 3.5 durante la compilazione di un'applicazione per la distribuzione privata o per la distribuzione centrale di SQL Server Compact 3.5 sono leggermente diverse. Per la distribuzione centrale, effettuare le seguenti operazioni.

Per aggiungere un riferimento a SQL Server Compact 3.5 per la distribuzione centrale

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento.

    Nota

    Se la cartella Riferimenti non è disponibile in Esplora soluzioni, fare clic su Mostra tutti i file nella parte superiore della finestra di Esplora soluzioni.

  2. Nell'elenco di assembly .NET selezionare System.Data.SqlServerCe, quindi fare clic su OK. Se System.Data.SqlServerCe non è disponibile nell'elenco, eseguire la procedura seguente:

    1. Nella finestra di dialogo Aggiungi riferimento fare clic su Sfoglia.

    2. Passare alla seguente cartella: %Programmi%\Microsoft SQL Server Compact Edition\v3.5\Desktop.

    3. Selezionare System.Data.SqlServerCe.dll, quindi fare clic su OK.

    L'elenco di riferimenti in Esplora soluzioni include ora System.Data.SqlServerCe ed è possibile utilizzare tale assembly nel progetto.

    Nota

    Se per il progetto viene utilizzato Entity Framework, ripetere gli stessi passaggi per aggiungere un riferimento a System.Data.SqlServerCe.Entity. È possibile aggiungere System.Data.SqlServerCe.Entity dall'elenco di assembly .NET o passare a %Programmi%\Microsoft SQL Server Compact Edition\v3.5.

  3. In Esplora soluzioni fare clic con il pulsante destro del mouse su Form1.cs o Form1.vb e selezionare Visualizza codice.

  4. All'inizio del codice del form aggiungere una direttiva per l'utilizzo dello spazio dei nomi System.Data.SqlServerCe. Se si utilizza Entity Framework, aggiungere una direttiva per l'utilizzo dello spazio dei nomi System.Data.SqlServerCe. Per un'applicazione per Tablet PC, aggiungere inoltre una direttiva per l'utilizzo dell'API di 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

Aggiunta di SQL Server Compact 3.5 al progetto durante la compilazione per la distribuzione privata

Dopo aver creato il progetto, è necessario aggiungere un riferimento all'assembly SQL Server Compact 3.5. Le procedure per l'aggiunta di riferimenti agli assembly SQL Server Compact 3.5 durante la compilazione di un'applicazione per la distribuzione privata o per la distribuzione centrale di SQL Server Compact 3.5 sono leggermente diverse. Per la distribuzione privata, effettuare le seguenti operazioni.

Per aggiungere un riferimento a SQL Server Compact 3.5 per la distribuzione centrale

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento.

    Nota

    Se la cartella Riferimenti non è disponibile in Esplora soluzioni, fare clic su Mostra tutti i file nella parte superiore della finestra di Esplora soluzioni.

  2. Nella finestra di dialogo Aggiungi riferimento fare clic su Sfoglia.

  3. Passare alla cartella %Programmi%\Microsoft SQL Server Compact Edition\v3.5\Private.

  4. Selezionare System.Data.SqlServerCe, quindi fare clic su OK.

    L'elenco di riferimenti in Esplora soluzioni include ora System.Data.SqlServerCe ed è possibile utilizzare tale assembly nel progetto.

    Nota

    Se per il progetto viene utilizzato Entity Framework, ripetere gli stessi passaggi per aggiungere un riferimento a System.Data.SqlServerCe.Entity. Per la distribuzione privata, System.Data.SqlServerCe.Entity viene aggiunto anche dalla cartella %Programmi%\Microsoft SQL Server Compact Edition\v3.5\Private.

  5. In Esplora soluzioni fare clic con il pulsante destro del mouse su Form1.cs o Form1.vb e selezionare Visualizza codice.

  6. All'inizio del codice del form aggiungere una direttiva per l'utilizzo dello spazio dei nomi System.Data.SqlServerCe. Se si utilizza Entity Framework, aggiungere una direttiva per l'utilizzo dello spazio dei nomi System.Data.SqlServerCe. Per un'applicazione per Tablet PC, aggiungere inoltre una direttiva per l'utilizzo dell'API di 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

Configurazione di SQL Server Compact per la distribuzione privata

Per compilare un'applicazione in cui viene utilizzata la distribuzione privata per SQL Server Compact 3.5, assicurarsi che il provider di dati .NET Framework e tutte le DLL native necessarie vengano distribuiti nella directory di output dell'applicazione. Se si desidera che nell'applicazione si utilizzi la distribuzione privata per SQL Server Compact 3.5, è necessario effettuare le operazioni riportate in questa sezione. Se per l'applicazione non viene utilizzata la distribuzione privata, ignorare questa sezione. Per ulteriori informazioni sulla distribuzione privata di SQL Server Compact 3.5, vedere Confronto tra la distribuzione privata e la distribuzione centrale (SQL Server Compact). Nei passaggi seguenti si presuppone che l'applicazione sia compilata per qualsiasi piattaforma (a 32 bit e 64 bit). Se l'applicazione è destinata solo a una di queste piattaforme, è possibile omettere i passaggi validi per l'altra piattaforma.

Per configurare l'applicazione per la distribuzione privata di SQL Server Compact

  1. Configurare il provider di dati .NET Framework affinché l'assembly SQL Server Compact 3.5 venga copiato nella directory di output quando il progetto viene compilato.

    1. In Esplora soluzioni espandere Riferimenti, fare clic con il pulsante destro del mouse su System.Data.SqlServerCe e selezionare Proprietà.

    2. In Proprietà riferimenti di System.Data.SqlServerCe, impostare Copia localmente su True.

    Nota

    Se per il progetto viene utilizzato Entity Framework, ripetere gli stessi passaggi di System.Data.SqlServerCe.Entity per configurare il provider di dati Entity Framework affinché SQL Server Compact 3.5 venga copiato nella directory di output.

  2. Aggiungere le librerie native di SQL Server Compact 3.5 a 32 bit necessarie al progetto.

    1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi, quindi selezionare Nuova cartella. Assegnare alla cartella il nome x86.

    2. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla cartella x86, scegliere Aggiungi, quindi selezionare Elemento esistente.

    3. Nella finestra di dialogo Aggiungi elemento esistente passare alla cartella in cui si trovano le librerie native a 32 bit. In una versione a 32 bit di Windows la cartella è %Programmi%\Microsoft SQL Server Compact Edition\v3 .5. In una versione a 64 bit di Windows è invece %Programmi (x86)%\Microsoft SQL Server Compact Edition\v3.5.

    4. Premere Ctrl+clic su ognuna delle librerie native necessarie per il progetto per selezionarle nell'elenco dei file, quindi fare clic su OK. Le librerie vengono aggiunte alla cartella x86.

      Nota

      È necessario aggiungere almeno le librerie seguenti: sqlceme35.dll, sqlceqp35.dll, sqlcese35.dll e sqlceer35.dll.

  3. Aggiungere le librerie native di SQL Server Compact 3.5 a 64 bit necessarie al progetto.

    1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi, quindi selezionare Nuova cartella. Assegnare alla cartella il nome x64.

    2. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla cartella x64, scegliere Aggiungi, quindi selezionare Elemento esistente.

    3. Nella finestra di dialogo Aggiungi elemento esistente passare alla cartella in cui si trovano le librerie native a 64 bit. In una versione a 64 bit di Windows la cartella è %Programmi%\Microsoft SQL Server Compact Edition\v3 .5.

      Nota

      Non è possibile installare la versione a 64 bit di SQL Server Compact 3.5 in un computer che esegue una versione a 32 bit di Windows. Per aggiungere le librerie native a 64 bit a un progetto compilato in un ambiente di sviluppo a 32 bit, è necessario innanzitutto estrarre i file dal programma di installazione a 64 bit in una directory sul computer di sviluppo. Successivamente, è possibile passare a tale directory per aggiungere le librerie native a 64 bit al progetto. Per informazioni sull'estrazione dei file dal programma di installazione, vedere Procedura: Estrazione di DLL a 64 bit dal programma di installazione del runtime di SQL Server Compact.

    4. Premere Ctrl+clic su ognuna delle librerie native necessarie per il progetto per selezionarle nell'elenco dei file, quindi fare clic su OK. Le librerie vengono aggiunte alla cartella x64.

      Nota

      È necessario aggiungere almeno le librerie seguenti: sqlceme35.dll, sqlceqp35.dll, sqlcese35.dll e sqlceer35.dll.

  4. Configurare ognuna delle librerie native aggiunte nei passaggi precedenti affinché vengano copiate nella directory di output quando il progetto viene compilato. Questa operazione è necessaria per le librerie di entrambe le directory.

    1. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla libreria (ad esempio, sqlcese35.dll) e selezionare le proprietà.

      Nota

      Se gli assembly non sono elencati in Esplora soluzioni, fare clic su Mostra tutti i file nella parte superiore di Esplora soluzioni.

    2. In Proprietà del file selezionare Copia sempre o Copia se più recente dall'elenco a discesa Copia nella directory di output.

  5. Configurare il progetto da compilare per Qualsiasi CPU.

    1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e selezionare Proprietà per aprire Progettazione progetti.

    2. Fare clic su Compila e selezionare Qualsiasi CPU dall'elenco a discesa Piattaforma di destinazione.

Utilizzo degli oggetti di SQL Server Compact 3.5

Dopo l'aggiunta dello spazio dei nomi System.Data.SqlServerCe, è possibile iniziare a creare codice utilizzando gli oggetti di SQL Server Compact 3.5. Nell'esempio di codice seguente viene illustrato come utilizzare l'oggetto Engine per creare un nuovo file di database di SQL Server Compact 3.5.

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

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe (documentazione di riferimento di .NET Framework)