Share via

Modèle de projet de modèle Word

  • Article

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

  • Word 2007

  • Word 2003

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

Le modèle de projet Word en Visual Basic et en Visual C# sert de point de départ pour les solutions basées sur les modèles Microsoft Office Word nouveaux ou existants. Il existe différents modèles de projet pour Word 2003 et Word 2007. Les modèles de projet ajoutent automatiquement les références d'assembly, les fichiers et le code généré nécessaires à utiliser comme base pour votre solution.

Les modèles Word qui référencent les extensions de code managé ne peuvent pas être utilisés comme compléments globaux. L'assembly n'est pas appelé si le modèle est chargé à partir du répertoire Startup de Word. Pour plus d'informations, consultez Restrictions relatives aux modèles globaux et aux compléments Excel (fichiers .xla).

Si vous ouvrez un modèle pour le modifier en dehors de Visual Studio après avoir compilé la solution, le modèle exécute le code comme si vous aviez créé un document à partir du modèle. Selon le code, le modèle risque d'être changé lors de l'ouverture, avant que vous ne commenciez les modifications. Pour empêcher l'exécution du code, maintenez la touche MAJ enfoncée pendant que vous ouvrez le modèle.

Remarque :

Par défaut, certains fichiers et références de la liste suivante sont masqués. Pour les consulter, cliquez sur Afficher tous les fichiers dans la barre d'outils de l'Explorateur de solutions. De plus, certains fichiers et références, non répertoriés dans la liste suivante, sont communs à de nombreux modèles de projet Visual Studio.

Fichiers

Visual Studio Tools pour Office génère les fichiers visibles suivants dans Word 2003 et dans les projets de modèle Word 2007 :

  • NomDocument.dot - représente le modèle Word dans un projet. Contient l'aire de conception du document et le fichier de code.

  • ThisDocument (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - document fournissant l'aire de conception et le fichier de code. Pour plus d'informations, consultez Élément hôte de document.

Remarque :

Vous ne pouvez pas ajouter de classes supplémentaires au fichier de code derrière un document, un classeur ou une feuille de calcul. Vous devez ajouter de nouveaux fichiers à votre projet pour contenir toutes les classes que vous souhaitez écrire.

Visual Studio Tools pour Office génère également le fichier supplémentaire suivant lorsque vous générez un projet de modèle Word 2007 :

Fichiers masqués

Visual Studio Tools pour Office génère plusieurs fichiers masqués. Ne modifiez pas ces fichiers manuellement ; ils sont régénérés lorsque les modifications sont apportées au projet et ils ne conservent pas les modifications manuelles.

Visual Studio Tools pour Office génère les fichiers masqués suivants :

  • ThisDocument.Designer.xml : représentation déclarative en lecture seule des objets programmables du document.

  • ThisDocument.Designer (fichier .vb ou fichier .cs) : fichier de code en lecture seule qui fournit des implémentations d'assistance pour les objets dans le document, y compris le code pour instancier les objets correctement.

  • Document Name.Designer.xml : représentation déclarative en lecture seule d'objets programmables, tels que des contrôles personnalisés qui ne font pas partie de Visual Studio Tools pour Office par défaut. Ce fichier est généré lorsque vous ajoutez un contrôle personnalisé au document.

  • Document Name.Designer (fichier .vb ou fichier .cs) : fichier de code en lecture seule qui fournit des implémentations d'assistance pour les contrôles personnalisés. Ce fichier est généré lorsque vous ajoutez un contrôle personnalisé au document.

Code du modèle

Les gestionnaires d'événements suivants sont inclus dans les fichiers de code de modèle de projet. Pour plus d'informations, consultez Événements de projet Visual Studio Tools pour Office.

ThisDocument_Startup

ThisDocument_Startup gère l'événement Document.Startup. Cet événement est déclenché après le démarrage de l'exécution de la solution et l'exécution de tout le code d'initialisation dans l'assembly. Utilisez ce gestionnaire d'événements pour exécuter le code qui initialise la solution.

ThisDocument_Shutdown

ThisDocument_Shutdown gère l'événement Document.Shutdown. Cet événement est déclenché lorsque le domaine d'application dans lequel le code est chargé est sur le point d'être déchargé.

Références

Visual Studio Tools pour Office crée automatiquement un jeu de références d'assembly dans les projets de modèle Word. Ces références incluent les assemblys suivants :

Voir aussi

Tâches

Comment : créer des projets Visual Studio Tools pour Office

Concepts

Vue d'ensemble des assemblys dans les solutions Office

Vue d'ensemble du modèle objet Word

Autres ressources

Gestion des solutions, des projets et des fichiers

Modèles de projet Office