Procédure pas à pas : déploiement d'un document et d'un assembly dans un dossier local (Office System 2003)

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets et versions Visual Studio Tools pour Office spécifiés de Microsoft Office. Type de projet Projets au niveau du document Version de Microsoft Office Microsoft Office 2003 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations de cette rubrique s'appliquent uniquement aux projets et versions Visual Studio Tools pour Office spécifiés de Microsoft Office.

Type de projet

Projets au niveau du document

Version de Microsoft Office

Microsoft Office 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Cette procédure pas à pas montre comment déployer une personnalisation au niveau du document dans un nouveau dossier sur votre ordinateur de développement, de sorte que le document et l'assembly soient situés dans le même dossier. Ce type de déploiement est appelé modèle de déploiement local/local.

Pour plus d'informations sur les options disponibles pour le déploiement de votre solution, consultez Modèles de déploiement (Office System 2003). Pour plus d'informations sur les personnalisations au niveau du document, consultez Architecture des personnalisations au niveau du document.

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

Octroi d'un niveau de confiance totale à un assembly de solution Visual Studio Tools pour Office situé dans un dossier local.

Composants requis

Les composants suivants sont nécessaires pour exécuter cette procédure pas à pas :

Visual Studio Tools pour Office (un composant facultatif de Visual Studio 2008 Professional et Visual Studio Team System).

Microsoft Office Word 2003 ou Microsoft Office Excel 2003.

Remarque :
Cette procédure pas à pas suppose que vous déployez une solution Word. Si vous souhaitez exécuter la procédure pas à pas avec une solution Excel, remplacez le nom du projet Word par le nom de votre projet Excel dans tous les exemples de code.

Droits d'administrateur sur l'ordinateur de développement pour que vous puissiez définir la stratégie de sécurité.

Création d'une solution à déployer

La première étape consiste à créer une solution Visual Studio Tools pour Office de base à déployer. Si vous possédez déjà une solution que vous souhaitez déployer, vous pouvez ignorer cette section et passer à l'étape « Déploiement de la solution ».

Pour créer une solution à déployer

À l'aide du modèle de projet pour Office 2003, créez un projet de document Word nommé WordDeployment.

Dans l'Assistant, sélectionnez Créer un nouveau document. Pour plus d'informations, consultez Comment : créer des projets Visual Studio Tools pour Office.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code ThisDocument, puis cliquez sur Afficher le code.
Ajoutez le code suivant au gestionnaire d'événements ThisDocument_Startup. Lorsque le document s'ouvre, ce code affiche un message qui permet de vérifier facilement si la solution a été déployée.
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Pour plus d'informations sur l'événement Startup, consultez Événements de projet Visual Studio Tools pour Office.
Appuyez sur F5 pour générer et exécuter le projet. Vérifiez que le message apparaît.

Déploiement de la solution

Vous pouvez désormais déployer le document et l'assembly dans un nouveau dossier sur l'ordinateur de développement.

Pour déployer la solution

Créez un dossier appelé TestDeploy à la racine du lecteur système Windows (%SystemDrive%). Par exemple, si votre lecteur système est C, le répertoire correspond à C:\TestDeploy.
Copiez le document et l'assembly du dossier de sortie de génération (en général, dossier de projet\bin\debug ou dossier de projet\bin\release) vers le dossier %SystemDrive%\TestDeploy.
Ouvrez le document dans le dossier %SystemDrive%\TestDeploy. Un message d'erreur indique que la stratégie de sécurité .NET actuelle n'autorise pas l'exécution de la personnalisation. Cela est dû au fait que vous n'avez pas encore octroyé un niveau de confiance totale à l'assembly.
Cliquez sur OK, puis fermez le document.

Définition de la stratégie de sécurité

Pour pouvoir exécuter la solution, vous devez accorder une confiance totale à l'assembly dans votre stratégie de sécurité .NET Framework 2.0. Cette procédure pas à pas utilise l'outil Stratégie de sécurité d'accès du code (Caspol.exe) pour octroyer un niveau de confiance totale à l'assembly.

Pour plus d'informations sur l'utilisation de Caspol.exe, consultez Outil Code Access Security Policy Tool (Caspol.exe) et Configuration de la stratégie de sécurité à l'aide de l'outil Code Access Security Policy Tool (Caspol.exe).

Note de sécurité :
Il s'agit d'étapes de base qui permettent de définir une stratégie de sécurité basée sur la preuve URL pour exécuter cette procédure pas à pas. N'utilisez pas ces étapes pour octroyer un niveau de confiance totale aux assemblys dans une solution réelle si vous n'êtes pas certain que l'emplacement est sûr et sécurisé. De plus, vous devez baser la sécurité d'une solution réelle sur une preuve plus pertinente que l'URL de l'assembly. Pour plus d'informations, consultez Spécifications de sécurité pour exécuter des solutions Office (Office System 2003).

Il s'agit d'étapes de base qui permettent de définir une stratégie de sécurité basée sur la preuve URL pour exécuter cette procédure pas à pas. N'utilisez pas ces étapes pour octroyer un niveau de confiance totale aux assemblys dans une solution réelle si vous n'êtes pas certain que l'emplacement est sûr et sécurisé. De plus, vous devez baser la sécurité d'une solution réelle sur une preuve plus pertinente que l'URL de l'assembly. Pour plus d'informations, consultez Spécifications de sécurité pour exécuter des solutions Office (Office System 2003).

Pour octroyer un niveau de confiance totale à l'assembly

À l'invite de commandes, tapez la commande suivante pour créer un groupe de codes qui accorde un niveau de confiance totale à l'assembly. Remplacez chemin d'accès complet de l'assembly par le chemin d'accès complet de l'assembly sur l'ordinateur de développement, par exemple, C:\TestDeployAssembly\WordDeployment.dll.
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
Le paramètre -n indique un nom pour le nouveau groupe de codes. Ce paramètre n'est pas obligatoire, mais le fait d'indiquer une étiquette facilite l'identification et la suppression du nouveau groupe de codes une fois cette procédure pas à pas terminée.
À l'invite, tapez oui pour confirmer que vous souhaitez exécuter l'opération, puis appuyez sur la touche ENTRÉE.
Ouvrez le document dans le dossier %SystemDrive%\TestDeploy et vérifiez que le message apparaît.
Cliquez sur OK, puis fermez le document.

Étapes suivantes

Vous pouvez également déployer le document et l'assembly dans des dossiers différents sur le même ordinateur ou les déployer dans un dossier réseau. Pour plus d'informations, consultez les procédures pas à pas suivantes :