Vue d'ensemble de Visual Studio Tools pour Office Runtime
Mise à jour : novembre 2007
Pour exécuter des solutions créées à l'aide Visual Studio Tools pour Office, les ordinateurs des utilisateurs finaux doivent posséder Visual Studio Tools pour Office Runtime. Ce dernier inclut des assemblys managés qui fournissent la couche de communication entre votre solution et l'application Microsoft Office et des composants non managés que l'application utilise pour charger votre solution.
Pour plus d'informations sur l'installation du runtime sur les ordinateurs d'utilisateurs finaux, consultez Comment : installer Visual Studio Tools pour Office Runtime.
Cette rubrique fournit les informations suivantes :
Fonctionnement des différentes versions du runtime
Fonctionnement des assemblys du runtime
Fonctionnement des composants du chargeur du runtime
Fonctionnement des différentes versions du runtime
Les solutions Visual Studio Tools pour Office pour différentes versions de Microsoft Office requièrent des versions différentes du runtime. La version du runtime est déterminée par le modèle de projet utilisé pour créer la solution, et non pas par la version d'Office qui exécute la solution.
Le tableau suivant affiche quelles versions du runtime et de Microsoft Office sont requises pour exécuter des solutions sur l'ordinateur de l'utilisateur final.
Version de modèle de projet |
Version du runtime Visual Studio Tools pour Office requise sur l'ordinateur de l'utilisateur final |
Versions Microsoft Office pouvant exécuter la solution sur l'ordinateur de l'utilisateur final |
---|---|---|
Projets pour la version 2007 de Microsoft Office System |
Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime) |
Version 2007 de Microsoft Office System |
Projets pour Microsoft Office 2003 |
Visual Studio 2005 Tools pour Office Second Edition Runtime |
Version 2007 de Microsoft Office System Microsoft Office 2003 |
Les deux versions du runtime sont installées automatiquement sur l'ordinateur de développement lorsque vous installez Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0).
Pour plus d'informations sur la création de solutions pouvant s'exécuter avec les deux versions de Microsoft Office, consultez Création de solutions pour plusieurs versions de Microsoft Office.
Il existe quelques différences entre les assemblys inclus dans chaque version du runtime. Pour plus d'informations, consultez Différences d'Assembly.
Remarque : |
---|
Le Visual Studio 2005 Tools pour Office Second Edition Runtime a été diffusé initialement avec Microsoft Visual Studio 2005 Tools pour la version 2007 de Microsoft Office System (VSTO 2005 SE). Cette version du runtime est également utilisée par les solutions pour Microsoft Office 2003 créées à l'aide de Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0). |
Localisation de la documentation de référence pour les deux runtime
Lorsque vous cliquez sur un lien ou une entrée d'index dans l'Aide pour obtenir des informations de référence sur un espace de noms, un type ou un membre, vous pouvez obtenir deux résultats presque identiques. Les deux rubriques documentent les mêmes membres dans les deux versions du runtime. Sélectionnez la rubrique identifiée par l'indicateur de version approprié :
2007, système. Fait référence à Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime).
2003, système. Fait référence à Visual Studio 2005 Tools pour Office Second Edition Runtime.
Fonctionnement des assemblys du runtime
Les assemblys inclus dans le runtime Visual Studio Tools pour Office fournissent les catégories de classes suivantes :
Classes que votre solution utilise pour automatiser et étendre l'application hôte.
Classes d'infrastructure qui activent votre solution pour communiquer avec l'application hôte.
Remarque : |
---|
Lorsque vous créez un projet, Visual Studio Tools pour Office ajoute automatiquement des références aux assemblys utilisés pour le type de projet. Certains des assemblys sont utilisés uniquement dans des projets au niveau du document et d'autres uniquement dans des projets au niveau de l'application. |
Assemblys dans le runtime de Visual Studio Tools pour Office 3.0
Le tableau suivant répertorie les assemblys inclus dans Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime). Cette version du runtime est utilisée par les solutions créées pour la version 2007 de Microsoft Office System.
Pour de la documentation sur les espaces de noms et les classes dans ces assemblys, consultez Référence managée pour Office System 2007.
Nom de l'assembly |
Description |
---|---|
Microsoft.Office.Tools.Common.v9.0.dll |
Fournit les classes suivantes :
|
Microsoft.Office.Tools.Excel.v9.0.dll |
Fournit des éléments hôtes et des contrôles hôtes pour les personnalisations au niveau du document Excel. Pour plus d'informations, consultez Vue d'ensemble des éléments hôtes et des contrôles hôtes. |
Microsoft.Office.Tools.Outlook.v9.0.dll |
Fournit des classes que vous pouvez utiliser pour créer des zones de formulaire personnalisées dans les compléments Outlook. |
Microsoft.Office.Tools.Word.v9.0.dll |
Fournit des éléments hôtes et des contrôles hôtes pour les personnalisations au niveau du document Word. Pour plus d'informations, consultez Vue d'ensemble des éléments hôtes et des contrôles hôtes. |
Microsoft.Office.Tools.v9.0.dll |
Fournit les classes suivantes :
|
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll |
Fournit les classes suivantes :
|
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll |
Fournit les classes suivantes :
|
Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll |
Fournit les classes suivantes :
|
Microsoft.VisualStudio.Tools.Office.AppInfoDocument.v9.0.dll Microsoft.VisualStudio.Tools.Office.Contract.v9.0.dll |
Fournit des classes faisant partie de l'infrastructure Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime). Ces classes ne sont pas destinées à être utilisées directement à partir de votre code. |
Assemblys dans Visual Studio 2005 Tools pour Office Runtime Second Edition
Le tableau suivant répertorie les assemblys inclus dans Visual Studio 2005 Tools pour Office Second Edition Runtime. Cette version du runtime est utilisée par les solutions créées pour Microsoft Office 2003.
Pour de la documentation sur les espaces de noms et les classes dans ces assemblys, consultez Référence managée pour Office System 2003.
Nom de l'assembly |
Description |
---|---|
Microsoft.Office.Tools.Common.dll |
Fournit les classes suivantes :
|
Microsoft.Office.Tools.Excel.dll |
Fournit des éléments hôtes et des contrôles hôtes pour les personnalisations au niveau du document Excel. Pour plus d'informations, consultez Vue d'ensemble des éléments hôtes et des contrôles hôtes. |
Microsoft.Office.Tools.Word.dll |
Fournit des éléments hôtes et des contrôles hôtes pour les personnalisations au niveau du document Word. Pour plus d'informations, consultez Vue d'ensemble des éléments hôtes et des contrôles hôtes. |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
Fournit les classes suivantes :
|
Différences d'assembly
Plusieurs assemblys inclus dans Visual Studio 2005 Tools pour Office Second Edition Runtime ont des noms différents dans Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime). De plus, un assembly qui fait partie de Visual Studio 2005 Tools pour Office Second Edition Runtime a été fractionné en plusieurs nouveaux assemblys dans Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime).
Le tableau suivant répertorie les différences.
Nom de l'assembly dans Visual Studio 2005 Tools pour Office Second Edition Runtime |
Nom de l'assembly dans Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime) |
---|---|
Microsoft.Office.Tools.Common.dll |
Microsoft.Office.Tools.Common.v9.0.dll |
Microsoft.Office.Tools.Excel.dll |
Microsoft.Office.Tools.Excel.v9.0.dll |
Microsoft.Office.Tools.Word.dll |
Microsoft.Office.Tools.Word.v9.0.dll |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll Certaines classes ont également été déplacées dans les nouveaux assemblys suivants :
|
Fonctionnement des composants du chargeur du runtime
Le runtime Visual Studio Tools pour Office inclut plusieurs DLL non managées que les applications Microsoft Office utilisent pour charger des solutions Visual Studio Tools pour Office. Même si vous ne devriez jamais avoir à utiliser directement ces DLL, savoir à quoi elles servent peut vous aider à mieux comprendre l'architecture des solutions Visual Studio Tools pour Office.
Pour plus d'informations sur la façon dont ces composants sont utilisés pendant le processus de chargement, consultez Architecture des personnalisations au niveau du document et Architecture des compléments d'application.
Chargeur du runtime
Lorsqu'un utilisateur ouvre une personnalisation au niveau du document ou démarre un complément, l'application Microsoft Office appelle le chargeur de runtime. Ce composant est appelé VSTOEE.dll.
Le chargeur de runtime vérifie que la bonne version du runtime Visual Studio Tools pour Office est chargée pour la version de Microsoft Office qui charge le complément. Bien que plusieurs versions du runtime Visual Studio Tools pour Office puissent être installées sur un même ordinateur, seule une instance de VSTOEE.dll est installée à la fois. Il s'agit du fichier VSTOEE.dll qui avait été inclus avec la version la plus récente du runtime installée sur l'ordinateur.
Chargeur de solution
Le chargeur de solution effectue la plupart du travail requis pour charger l'assembly de solution. Le chargeur de solution possède des noms de fichier différents selon la version du runtime de Visual Studio Tools pour Office. Le chargeur de solution dans Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime) est appelé VSTOLoader.dll. Dans Visual Studio 2005 Tools pour Office Second Edition Runtime, il est appelé AddinLoader.dll.
Le chargeur de solution effectue plusieurs tâches :
Il crée un nouveau domaine d'application pour chaque assembly de solution Visual Studio Tools pour Office.
Il exécute un ensemble de contrôles de vérification de la sécurité pour s'assurer que l'exécution de l'assembly du complément est autorisée.
Le chargeur de solution effectue également plusieurs tâches spécifiques des compléments :
Il implémente l'interface IDTExtensibility2. IDTExtensibility2 est une interface COM que tous les compléments pour applications Microsoft Office doivent implémenter. Cette interface définit des méthodes que l'application appelle pour communiquer avec le complément.
Implémente l'interface IManagedAddin. Cette interface est utilisée par les applications Office, à partir de la version 2007, pour aider à charger des compléments Visual Studio Tools pour Office. Pour plus d'informations, consultez Interface IManagedAddin.
Voir aussi
Tâches
Comment : installer Visual Studio Tools pour Office Runtime
Comment : créer des projets Visual Studio Tools pour Office
Concepts
Architecture des personnalisations au niveau du document
Architecture des compléments d'application
Mise à niveau et migration de solutions Office