Procédure pas à pas : ajout d'une base de données SQL Server Compact 3.5 à une application et son déploiement

Article
08/21/2008

Mise à jour : novembre 2007

Cette procédure pas à pas fournit des instructions détaillées sur l'incorporation d'une base de données SQL Server Compact 3.5 dans une application Windows.

Cette procédure pas à pas décrit les tâches suivantes :

Création d'une application Windows.
Ajout d'une base de données SQL Server Compact 3.5 à un projet.
Création de contrôles Windows Forms liés aux données.
Déploiement de l'application (y compris la base de données) à l'aide du déploiement ClickOnce.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez utiliser :

SQL Server Compact 3.5

Création d'une application Windows

La première étape consiste à créer un projet d'application Windows.

Remarque :
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour créer une nouvelle application Windows

Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Nommez le projet ProcédureSQLCompact.
Cliquez sur Application Windows, puis sur OK. Pour plus d'informations, consultez Création d'applications Windows.

Le projet ProcédureSQLCompact est créé et ajouté à l'Explorateur de solutions.

Ajout de la base de données et création de la source de données

L'étape qui suit la création du projet consiste à ajouter la base de données SQL Server Compact 3.5 au projet et à créer une source de données à partir des tables de la base de données. La nouvelle source de données sera utilisée pour glisser-déplacer la liaison de données à partir de la fenêtre Sources de données dans la section suivante.

Dans cette procédure, vous allez créer une source de données à partir de la table Customers de l'exemple de base de données Northwind à l'aide de l'AssistantConfiguration de source de données. L'Assistant Configuration de source de données démarre automatiquement lorsqu'un fichier de base de données SQL Server Compact 3.5 est ajouté à un projet.

Remarque :
L'exemple de base de données Northwind pour SQL Server Compact 3.5 est appelé Northwind.sdf et est situé dans C:\Program Files\Microsoft SQL Server Compact Edition\v3.5\Samples.

Pour créer la source de données

Dans le menu Projet, cliquez sur Ajouter un élément existant.
Dans la boîte de dialogue Ajouter un élément existant, accédez à l'emplacement du fichier Northwind.sdf, puis cliquez sur Ajouter.

Remarque :

Dans la boîte de dialogue Ajouter un élément existant, vous devez cliquer sur Fichiers de données dans la liste Objets de type pour faire apparaître le fichier .sdf.

Une fois que vous avez ajouté le fichier de base de données, l'Assistant Configuration de source de données s'ouvre à la page Choisir vos objets de base de données.
Développez le nœud Tables et activez la table Customers.
Cliquez sur Terminer et le fichier de base de données (Northwind.sdf) est ajouté au projet avec un groupe de données typé (NorthwindDataset).

Remarque :
Dans la boîte de dialogue Ajouter un élément existant, vous devez cliquer sur Fichiers de données dans la liste Objets de type pour faire apparaître le fichier .sdf.

Création de contrôles pour afficher les données

Maintenant que la source de données est créée et disponible dans la fenêtre Sources de données, vous pouvez faire glisser la table sur un Windows Form pour créer une grille liée aux données.

Pour ajouter au Windows Form une grille liée aux données

Depuis la fenêtre Sources de données, faites glisser le nœud Customers vers Form1.
Appuyez sur F5 pour exécuter l'application.

Le formulaire apparaît avec les données client chargées dans la grille.

Déploiement de l'application

En supposant que l'application soit complète, vous êtes maintenant prêt à la déployer. Pour cette procédure pas à pas, vous allez utiliser le déploiement ClickOnce.

La création d'un déploiement ClickOnce pour une application contenant une base de données SQL Server Compact 3.5 consiste à configurer les informations de publication appropriées dans le Concepteur de projets.

Remarque :
L'ajout d'un fichier de base de données SQL Server Compact 3.5 à un projet configure automatiquement les informations de publication appropriées pour le déploiement ClickOnce. Toutefois, dans cette procédure pas à pas, vous allez inspecter et vérifier chaque paramètre pour comprendre comment le déploiement fonctionne.

Pour configurer le déploiement ClickOnce d'une application ayant une base de données SQL Server Compact 3.5

Pour ouvrir le Concepteur de projets, dans l'Explorateur de solutions, double-cliquez sur My Project si vous travaillez sur un projet Visual Basic (ou Propriétés si vous travaillez sur un projet C#).
Cliquez sur l'onglet Publier.
Cliquez sur Fichiers d'application, puis affectez Fichier de données (Auto) à l'État de la publication du fichier Northwind.sdf.

Ce paramètre demande au programme d'installation de placer ce fichier dans le répertoire des données.
Cliquez sur OK.
Cliquez sur Composants requis, puis activez la case à cocher en regard de SQL Server Compact 3.5.

Ce paramètre demande au programme d'installation de vérifier si le runtime SQL Server Compact 3.5 existe et, dans le cas contraire, de l'installer à partir d'Internet.

Création du programme d'installation

Maintenant que les informations de publication sont configurées pour déployer la base de données SQL Server Compact 3.5 avec l'application, il est temps de créer le programme d'installation.

Pour créer le programme d'installation

Dans la zone Emplacement de publication, cliquez sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Ouvrir le site Web.
Cliquez sur Système de fichiers.
Créez un dossier où déployer le programme d'installation, puis sélectionnez-le.

Remarque :

Vous pouvez créer le dossier à n'importe quel emplacement. Souvenez-vous bien simplement de l'endroit afin de retrouver le dossier ultérieurement.
Cliquez sur Ouvrir.
Cliquez sur Publier maintenant pour créer le programme d'installation.

Remarque :
Vous pouvez créer le dossier à n'importe quel emplacement. Souvenez-vous bien simplement de l'endroit afin de retrouver le dossier ultérieurement.

Étapes suivantes

Copiez le dossier que vous venez de créer sur un ordinateur qui ne contient pas SQL Server Compact 3.5, puis installez l'application en exécutant le programme d'installation. Le programme d'installation détecte le composant requis SQL Server Compact 3.5 et installe SQL Server Compact 3.5 dans le cadre de l'installation de l'application.

Voir aussi