Protection des documents dans les solutions au niveau du document

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Version de Microsoft Office Microsoft Office 2003 Version 2007 de Microsoft Office System 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 Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau du document

Version de Microsoft Office

Microsoft Office 2003
Version 2007 de Microsoft Office System

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

Vous pouvez utiliser les fonctionnalités de protection de Microsoft Office Word et Microsoft Office Excel dans vos projets Visual Studio Tools pour Office. Ces fonctionnalités empêchent les utilisateurs non autorisés de modifier certaines parties protégées d'un document.

À l'aide d'Excel, vous pouvez activer et désactiver la protection pendant que le classeur est ouvert dans le concepteur. Avec Word, vous pouvez uniquement l'activer en dehors du concepteur. Au moment de l'exécution, vous pouvez activer ou désactiver la protection par programme pour Word et Excel.

Lorsque la protection de document est activée dans un document ouvert dans le concepteur, tous les contrôles sont supprimés de la boîte à outils ou deviennent indisponibles, et vous ne pouvez rien faire glisser de la fenêtre Sources de données vers le document.

Document serveur et documents protégés

Si un document est protégé, il est impossible d'accéder au cache depuis l'extérieur du document. Vous ne pouvez pas utiliser ServerDocument pour récupérer ou manipuler des données mises en cache dans le document, ni vous servir des autres fonctions de ServerDocument.

Protection des documents Word dans le concepteur

Si vous ajoutez une protection à un document ou modèle Word alors qu'il est ouvert dans Visual Studio, vous ne pouvez pas activer cette protection dans le concepteur. Le document est en mode Design tant qu'il est ouvert dans Visual Studio et il doit passer en mode exécution avant que vous ne puissiez activer la protection.

Cependant, si vous créez un projet Visual Studio Tools pour Office qui utilise un document Word existant dont la protection est activée, le document est protégé pendant qu'il est ouvert dans le concepteur. Vous ne pouvez pas modifier les parties protégées du document, mais vous pouvez toujours écrire du code dans l'éditeur de code pour automatiser le document. Vous ne pouvez pas non plus générer le projet si la protection est activée pendant que le document est ouvert dans Visual Studio.

Vous pouvez désactiver la protection pendant que le document est ouvert dans le concepteur afin de pouvoir modifier le document et générer le projet. Vous ne pouvez pas désactiver la protection de la copie dans le concepteur pendant le débogage ; le document qui s'ouvre lors du débogage est une copie distincte de celui qui est ouvert dans le concepteur (la copie de sortie est stockée dans le répertoire \bin pour Visual Basic et \bin\debug pour C#).

Vous pouvez activer la protection dans la copie du document qui s'ouvre dans le concepteur en fermant le projet dans Visual Studio, en ouvrant la copie du document dans le répertoire du projet et en activant la protection.

Activation de la protection des documents Word au cours de la génération

Visual Studio Tools pour Office commence à activer la protection des documents et modèles Word lors du processus de génération, de sorte que la protection est activée lorsque le document s'ouvre pour le débogage. Le document est protégé avec un mot de passe vide.

La protection est activée pendant la génération de sorte que, si l'événement Startup du document contient un code susceptible de provoquer des exceptions ou de modifier le comportement de l'application, ce code puisse être débogué correctement. Si vous activez la protection après l'ouverture du document, le code d'initialisation ne peut pas être débogué ni testé.

Définition du mot de passe

Visual Studio Tools pour Office active automatiquement la protection, mais ne fournit aucun mot de passe par défaut. Si vous souhaitez que la protection de document utilise un mot de passe, vous devez l'ajouter avant de déployer votre solution. L'ajout d'un mot de passe vous permet de laisser les utilisateurs autorisés supprimer la protection du document ; sans mot de passe, il est difficile de supprimer la protection. Pour plus d'informations sur la définition d'un mot de passe, consultez l'aide de l'application Office concernée.