Vue d'ensemble de Visual Studio Tools pour Office Runtime

Article
04/28/2010

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

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 : La classe de base AddIn pour les compléments au niveau de l'application. Classes pour la création de volets Actions et de balises actives dans des personnalisations au niveau du document. Classes pour la création de volets de tâches personnalisés dans des compléments au niveau de l'application. Classes pour la création de personnalisations du ruban. Les classes ExcelLocale1033Attribute et ExcelLocale1033Proxy présentes dans les solutions Excel pour contrôler l'ID de paramètres régionaux (LCID) qui est utilisé pour tous les appels dépendants de la culture au modèle objet Excel. Pour plus d'informations, consultez Mise en forme de données dans Excel avec différents paramètres régionaux.
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 : La classe RemoteBindableComponent qui fournit les fonctions de liaison de données pour les contrôles hôtes dans les personnalisations au niveau du document. Autres classes faisant partie de l'infrastructure Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime) et qui ne sont pas destinées à être utilisées directement par votre code.
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll	Fournit les classes suivantes : L'attribut CachedAttribute et les classes ICachedType que vous pouvez utiliser pour mettre en cache des objets de données dans une personnalisation au niveau du document. Exceptions qui peuvent être levées par le runtime de Visual Studio Tools pour Office. Autres classes faisant partie de l'infrastructure Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime) et qui ne sont pas destinées à être utilisées directement par votre code.
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll	Fournit les classes suivantes : La classe ServerDocument que vous pouvez utiliser pour joindre par programme des assemblys de personnalisation aux documents et accéder aux données en mémoire cache dans les documents. Plusieurs classes qui représentent la hiérarchie de données en mémoire cache dans une personnalisation au niveau du document.
Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll	Fournit les classes suivantes : Les classes AddInSecurityEntry et UserInclusionList que vous pouvez utiliser pour créer des entrées de listes d'inclusion d'utilisateurs pour accorder un niveau de confiance à une solution Visual Studio Tools pour Office pour la version 2007 de Microsoft Office System. Pour plus d'informations, consultez Octroi de niveaux de confiance à des solutions Office à l'aide de listes d'inclusion (Office System 2007). Autres classes faisant partie de l'infrastructure Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime) et qui ne sont pas destinées à être utilisées directement par votre code.
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 : La classe de base AddIn pour les compléments au niveau de l'application. Classes pour la création de volets Actions et de balises actives dans des personnalisations au niveau du document.
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 : La classe ServerDocument que vous pouvez utiliser pour joindre par programme des personnalisations aux documents et accéder aux données en mémoire cache dans les documents. L'attribut CachedAttribute et les classes ICachedType que vous pouvez utiliser pour mettre en cache des objets de données dans une personnalisation au niveau du document. Exceptions qui peuvent être levées par le runtime de Visual Studio Tools pour Office. Autres classes faisant partie de l'infrastructure Visual Studio 2005 Tools pour Office Second Edition Runtime et qui ne sont pas destinées à être utilisées directement par votre code.

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 : Microsoft.Office.Tools.v9.0.dll Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll

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

Share via