Création d'applications pour les ordinateurs de bureau (SQL Server Compact)

  • Article

Vous pouvez utiliser SQL Server Compact comme banque de données pour les applications bureautiques. Dans cette rubrique, vous allez apprendre à ajouter SQL Server Compact à un produit Visual Studio, puis à écrire du code pour l'espace de noms System.Data.SqlServerCe. Des rubriques de référence managée pour l'espace de noms System.Data.SqlServerCe sont disponibles dans la Documentation de référence .NET Framework.

Création d'un projet pour ordinateurs

Pour créer une nouvelle application destinée aux ordinateurs de bureau, vous devez d'abord créer un projet dans Visual Studio. Pour une application bureautique, vous devez ajouter une référence à l'espace de noms Microsoft.Ink.

Notes

Si vous développez une application Tablet PC sur un ordinateur n'exécutant pas Windows XP Tablet PC, vous devez d'abord installer le kit de développement Microsoft Windows XP Tablet PC Edition Development Kit. Vous pouvez télécharger la dernière version en date à partir du Centre de développement Windows Mobile.

Pour créer un projet pour ordinateur de bureau

  1. Dans Visual Studio, dans le menu Fichier, pointez sur Nouveau, puis sélectionnez Projet.

  2. Dans la liste Modèles installés de la boîte de dialogue Nouveau projet, développez le langage de programmation à utiliser, puis sélectionnez Windows.

  3. Dans la liste Modèle, sélectionnez Application Windows Forms.

  4. Indiquez un nom et un emplacement pour votre projet, puis cliquez sur OK.

    Visual Studio crée un projet et affiche le formulaire principal (Formulaire1).

  5. (Facultatif) Dans la zone Explorateur de solutions, cliquez avec le bouton droit sur Références, puis sélectionnez Ajouter une référence.

    Notes

    Si le dossier Références n'est pas répertorié dans l'Explorateur de solutions, cliquez sur Afficher tous les fichiers en haut de celui-ci.

  6. (Facultatif) Dans la liste des assemblys .NET, sélectionnez Microsoft Tablet PC API, puis cliquez sur OK.

    La liste des références inclut maintenant Microsoft.Ink.

Ajout de SQL Server Compact 4.0 au projet lors de la génération pour le déploiement centralisé

Une fois le projet créé, vous devez ajouter une référence à l'assembly SQL Server Compact. Les procédures d'ajout de références aux assemblys SQL Server Compact varient légèrement selon que vous générez une application pour le déploiement privé ou pour le déploiement centralisé de SQL Server Compact. Suivez les étapes suivantes pour le déploiement central.

Pour ajouter une référence à SQL Server Compact 4.0 pour le déploiement centralisé

  1. Dans la zone Explorateur de solutions, cliquez avec le bouton droit sur Références puis sélectionnez Ajouter une référence.

    Notes

    Si le dossier Références n'est pas répertorié dans l'Explorateur de solutions, cliquez sur Afficher tous les fichiers en haut de celui-ci.

  2. Dans la liste des assemblys .NET, sélectionnez System.Data.SqlServerCe, puis cliquez sur OK. Si System.Data.SqlServerCe ne figure pas dans la liste, procédez comme suit :

    1. Dans la boîte de dialogue Ajouter une Référence, cliquez sur le bouton Parcourir.

    2. Naviguez jusqu'au dossier suivant : %Program Files%\Microsoft SQL Server Compact Edition\v4.0\Desktop.

    3. Sélectionnez System.Data.SqlServerCe.dll, puis cliquez sur OK.

    La liste des références de l'Explorateur de solutions comprend à présent System.Data.SqlServerCe, et votre projet peut utiliser cet assembly.

    Notes

    Si votre projet utilise Entity Framework, répétez les mêmes étapes pour ajouter une référence à System.Data.SqlServerCe.Entity. Vous pouvez ajouter System.Data.SqlServerCe.Entity dans la liste des assemblys .NET, ou vous pouvez naviguer jusqu'au dossier %Program Files%\Microsoft SQL Server Compact Edition\v4.0.

  3. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Form1.cs ou Form1.vb, puis sélectionnez Afficher le code.

  4. En haut du code pour le formulaire, ajoutez une directive d'utilisation de l'espace de noms System.Data.SqlServerCe. Si vous utilisez Entity Framework, ajoutez une directive pour utiliser l'espace de noms System.Data.SqlServerCe. Pour l'application Tablet PC, ajoutez également une directive pour l'utilisation de l'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

Ajout de SQL Server Compact 4.0 au projet lors de la génération pour le déploiement privé

Après avoir créé le projet, vous devez ajouter une référence à l'assembly SQL Server Compact. Les procédures d'ajout de références aux assemblys SQL Server Compact varient légèrement selon que vous générez une application pour le déploiement privé ou pour le déploiement centralisé de SQL Server Compact. Suivez ces étapes pour le déploiement privé.

Pour ajouter une référence à SQL Server Compact 4.0 pour le déploiement centralisé

  1. Dans la zone Explorateur de solutions, cliquez avec le bouton droit sur Références puis sélectionnez Ajouter une référence.

    Notes

    Si le dossier Références n'est pas répertorié dans l'Explorateur de solutions, cliquez sur Afficher tous les fichiers en haut de celui-ci.

  2. Dans la boîte de dialogue Ajouter une Référence, cliquez sur le bouton Parcourir.

  3. Naviguez jusqu'au dossier : %Program Files%\Microsoft SQL Server Compact Edition\v4.0\Private.

  4. Sélectionnez System.Data.SqlServerCe, puis cliquez sur OK.

    La liste des références de l'Explorateur de solutions comprend à présent System.Data.SqlServerCe, et votre projet peut utiliser cet assembly.

    Notes

    Si votre projet utilise Entity Framework, répétez les mêmes étapes pour ajouter une référence à System.Data.SqlServerCe.Entity. (Pour le déploiement privé, System.Data.SqlServerCe.Entity est ajouté également depuis le dossier : %Program Files%\Microsoft SQL Server Compact Edition\v4.0\Private.)

  5. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Form1.cs ou Form1.vb, puis sélectionnez Afficher le code.

  6. En haut du code pour le formulaire, ajoutez une directive d'utilisation de l'espace de noms System.Data.SqlServerCe. Si vous utilisez Entity Framework, ajoutez une directive pour utiliser l'espace de noms System.Data.SqlServerCe. Pour l'application Tablet PC, ajoutez également une directive pour l'utilisation de l'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

Configuration de SQL Server Compact pour le déploiement privé

Pour générer une application qui utilise le déploiement privé pour SQL Server Compact, vous devez vérifier que le fournisseur de données .NET Framework et toutes les DLL natives nécessaires sont déployés dans le répertoire de sortie de l'application. Si vous souhaitez que votre application utilise le déploiement privé pour SQL Server Compact, vous devez suivre les étapes de cette section. Si votre application n'utilise pas de déploiement privé, ignorez cette section. Pour plus d'informations sur le déploiement privé de SQL Server Compact, consultez Comparaison entre déploiement privé et déploiement centralisé (SQL Server Compact). Les étapes suivantes supposent que l'application est générée pour cibler toutes les plateformes (32 bits et 64 bits). Si votre application cible une seule de ces plateformes, vous pouvez omettre des étapes qui s'appliquent à l'autre plateforme.

Pour configurer l'application pour le déploiement privé de SQL Server Compact

  1. Configurez le Fournisseur de données .NET Framework pour que l'assembly SQL Server Compact soit copié vers le répertoire de sortie lorsque le projet est généré.

    1. Dans l'Explorateur de solutions, développez Références puis cliquez avec le bouton droit sur System.Data.SqlServerCe et sélectionnez Propriétés.

    2. Dans Propriétés de la référenceSystem.Data.SqlServerCe, définissez Copie locale sur True.

    Notes

    Si votre projet utilise Entity Framework, répétez les mêmes étapes pour System.Data.SqlServerCe.Entity afin de configurer le Fournisseur de données Entity Framework de SQL Server Compact à copier vers le répertoire de sortie.

  2. Ajoutez les bibliothèques natives SQL Server Compact 32 bits nécessaires au projet.

    1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, pointez sur Ajouter, puis sélectionnez Nouveau dossier. Nommez le dossier x86.

    2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le dossier x86, pointez sur Ajouter, puis sélectionnez Élément existant.

    3. Dans la boîte de dialogue Ajouter un élément existant, recherchez le dossier dans lequel les bibliothèques natives 32 bits se trouvent. Sur une version 32 bits de Windows, l'emplacement est %Program Files%\Microsoft SQL Server Compact Edition\v4.0. Sur une version 64 bits de Windows, l'emplacement est %Program Files (x86)%\Microsoft SQL Server Compact Edition\v4.0.

    4. Cliquez en maintenant la touche Ctrl enfoncée sur chacune des bibliothèques natives nécessaires pour votre projet afin de les sélectionner dans la liste de fichiers, puis cliquez sur OK. Les bibliothèques sont ajoutées au dossier x86.

      Notes

      Au minimum, vous devez ajouter les bibliothèques suivantes : sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll et sqlceer40.dll.

  3. Ajoutez les bibliothèques natives SQL Server Compact 64 bits nécessaires au projet.

    1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, pointez sur Ajouter, puis sélectionnez Nouveau dossier. Nommez le dossier x64.

    2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le dossier x64, pointez sur Ajouter, puis sélectionnez Élément existant.

    3. Dans la boîte de dialogue Ajouter un élément existant, recherchez le dossier dans lequel les bibliothèques natives 64 bits se trouvent. Sur une version 64 bits de Windows, l'emplacement est %Program Files%\Microsoft SQL Server Compact Edition\v4.0.

      Notes

      Vous ne pouvez pas installer la version 64 bits de SQL Server Compact sur un ordinateur qui exécute une version 32 bits de Windows. Pour ajouter les bibliothèques natives 64 bits à un projet qui est construit dans un environnement de développement 32 bits, vous devez d'abord extraire les fichiers du programme d'installation 64 bits dans un répertoire sur l'ordinateur de développement. Vous pouvez ensuite naviguer jusqu'à ce répertoire pour ajouter les bibliothèques natives 64 bits à votre projet. Pour plus d'informations sur l'extraction de fichiers du programme d'installation, consultez Procédure : extraire les DLL 64-bits du programme d'installation du fichier d'exécution de SQL Server Compact.

    4. Cliquez en maintenant la touche Ctrl enfoncée sur chacune des bibliothèques natives nécessaires pour votre projet afin de les sélectionner dans la liste de fichiers, puis cliquez sur OK. Les bibliothèques sont ajoutées au dossier x64.

      Notes

      Au minimum, vous devez ajouter les bibliothèques suivantes : sqlceme40.dll, sqlceqp40.dll, sqlcese40.dll et sqlceer40.dll.

  4. Configurez chacune des bibliothèques natives ajoutées dans les étapes précédentes pour qu'elles soient copiées vers le répertoire de sortie lorsque le projet est généré. Vous devez procéder ainsi pour les bibliothèques qui se trouvent dans les deux répertoires.

    1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la bibliothèque (par exemple sqlcese40.dll) et sélectionnez ses propriétés.

      Notes

      Si les assemblys ne sont pas répertoriés dans l'Explorateur de solutions, cliquez sur Afficher tous les fichiers en haut de l'Explorateur de solutions.

    2. Dans le fichier Propriétés, sélectionnez Toujours copier ou Copier si plus récent dans la liste déroulante Copier dans le répertoire de sortie.

  5. Configurez le projet à générer pour Any CPU.

    1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet et sélectionnez Propriétés pour ouvrir le Concepteur de projet.

    2. Cliquez sur Build et sélectionnez Any CPU dans la liste déroulante Plateforme cible.

Utilisation des objets SQL Server Compact 4.0

Après avoir ajouté l'espace de noms System.Data.SqlServerCe, vous pouvez commencer à rédiger le code correspondant à l'aide des objets SQL Server Compact. L'exemple de code suivant montre comment utiliser l'objet Engine pour créer un nouveau fichier de base de données 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

Voir aussi

Référence

System.Data.SqlServerCe Namespace (documentation de référence .NET Framework)