Partager via

Modèle de projet de modèle Excel

  • 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

  • Excel 2007

  • Excel 2003

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

Le modèle de projet Excel en Visual Basic et en Visual C# sert de point de départ pour les solutions basées sur les modèles Microsoft Office Excel nouveaux ou existants. Il existe différents modèles de projet pour les modèles Excel 2003 et les modèles Excel 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.

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 à l'ouverture du 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 dans Excel 2003 et les projets de modèle Excel 2007  suivants :

  • Nom du classeur.xls - représente le classeur Excel dans le projet. Contient toutes les feuilles de calcul et graphiques.

  • Sheet1 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - feuille de calcul qui fournit l'aire de conception et le code de la première feuille de calcul dans le classeur. Pour plus d'informations, consultez Élément hôte de feuille de calcul.

  • Sheet2 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - feuille de calcul qui fournit l'aire de conception et le code de la deuxième feuille de calcul dans le classeur.

  • Sheet3 (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - feuille de calcul qui fournit l'aire de conception et le code de la troisième feuille de calcul dans le classeur.

  • ThisWorkbook (fichier .vb pour Visual Basic ou fichier .cs pour Visual C#) - contient l'aire de conception et le code des personnalisations au niveau du classeur. Pour plus d'informations, consultez Élément hôte de classeur.

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 Excel 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 :

  • ThisWorkbook.Designer.xml : représentation déclarative en lecture seule des objets programmables dans le classeur.

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

  • n.Designer.xml : représentation déclarative en lecture seule des objets programmables dans la feuille de calcul.

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

  • Workbook 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é à une feuille de calcul dans le classeur.

  • Workbook 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é à une feuille de calcul dans le classeur.

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.

Gestionnaires d'événements de démarrage

Ces gestionnaires d'événements gèrent les événements Workbook.Startup et Worksheet.Startup. Ces événements sont déclenchés pour chacune des feuilles de calcul et le classeur après le démarrage de l'exécution de la solution et de l'exécution du code d'initialisation dans l'assembly. Utilisez ces gestionnaires d'événements pour exécuter le code qui initialise la solution.

Les gestionnaires d'événements Startup dans une solution de modèle sont appelés dans cet ordre :

  1. ThisWorkbook_Startup.

  2. Sheet1_Startup.

  3. Sheet2_Startup.

  4. Sheet3_Startup.

  5. Les autres feuilles dans l'ordre.

L'ordre est déterminé lors de la compilation du projet. Si l'utilisateur réorganise les feuilles au moment de l'exécution, il ne modifie pas l'ordre dans lequel les événements sont déclenchés à l'ouverture suivante du classeur.

Gestionnaires d'événements d'arrêt

Ces gestionnaires d'événements gèrent les événements Workbook.Shutdown et Worksheet.Shutdown. Ces événements sont déclenchés pour chacune des feuilles de calcul et le classeur lorsque le domaine d'application dans lequel est chargé le code est sur le point d'être déchargé.

Les gestionnaires d'événements Shutdown dans une solution de modèle sont appelés dans cet ordre :

  1. ThisWorkbook_Shutdown.

  2. Sheet1_Shutdown.

  3. Sheet2_Shutdown.

  4. Sheet3_Shutdown.

  5. Les autres feuilles dans l'ordre.

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 Excel. Ces références incluent les assemblys suivants :

Voir aussi

Tâches

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

Concepts

Restrictions relatives aux modèles globaux et aux compléments Excel (fichiers .xla)

Vue d'ensemble des assemblys dans les solutions Office

Vue d'ensemble du modèle objet Excel

Autres ressources

Gestion des solutions, des projets et des fichiers

Modèles de projet Office