Vue d’ensemble du runtime Visual Studio Tools pour Office

  • Article

Pour exécuter des solutions créées à l’aide des outils de développement Microsoft Bureau dans Visual Studio, les outils Visual Studio 2010 pour Bureau runtime doivent être installés sur les ordinateurs de l’utilisateur final. Pour plus d’informations, consultez How to : Install the Visual Studio Tools pour Office runtime redistributable. Visual Studio 2010 Tools pour Bureau runtime se compose de deux composants principaux :

  • Extensions Office pour .NET Framework. Ces composants sont des assemblys managés qui fournissent la couche de communication entre votre solution et l'application Microsoft Office. Pour plus d’informations, consultez Comprendre les extensions Bureau pour .NET Framework.

  • Chargeur de solution Office. Ce composant est un ensemble de DLL non managées que les applications Office utilisent pour charger le runtime et vos solutions. Pour plus d’informations, consultez Comprendre le chargeur de solution Bureau.

    Le runtime peut être installé de plusieurs façons différentes. Selon la configuration de l'ordinateur, différents composants runtime sont installés lorsque vous installez le runtime. Pour plus d’informations, consultez Visual Studio Tools pour Office scénarios d’installation du runtime.

Comprendre les extensions Bureau pour .NET Framework

Visual Studio 2010 Tools pour Bureau runtime inclut Bureau extensions pour .NET Framework 3.5, .NET Framework 4 et versions ultérieures. Les solutions qui ciblent chaque version du .NET Framework, utilisent les extensions appropriées pour cette version.

Ces extensions se composent des assemblys que vos solutions utilisent pour automatiser et étendre des applications Office. Lorsque vous créez un projet Office, Visual Studio ajoute automatiquement des références aux assemblys utilisés pour le type de projet et la version .NET Framework cible du projet. Pour plus d’informations sur les assemblys des extensions Bureau, consultez Assemblys dans le runtime Visual Studio Tools pour Office.

Différences de conception dans les extensions de Bureau

La plupart des types que vous utilisez dans les extensions Office pour .NET Framework 3.5 sont des classes. Il s’agit des mêmes classes qui ont été incluses dans les versions précédentes du runtime Visual Studio Tools pour Office . En revanche, la plupart des types que vous utilisez dans les extensions Bureau pour .NET Framework 4 ou version ultérieure sont des interfaces. Par exemple, lorsque vous ciblez .NET Framework 4 ou version ultérieure, les Worksheet types et Document les interfaces sont des interfaces plutôt que des classes.

Dans la plupart des cas, le code que vous écrivez dans Bureau solutions est le même que votre solution cible le .NET Framework 3.5 ou le .NET Framework 4. Toutefois, certaines fonctionnalités requièrent un code différent lorsque vous ciblez des versions différentes du .NET Framework. Pour plus d’informations, consultez Migrer Bureau solutions vers .NET Framework 4 ou version ultérieure.

Interfaces dans les extensions Bureau pour .NET Framework 4 ou version ultérieure

La plupart des interfaces dans les extensions Bureau pour .NET Framework 4 ou version ultérieure ne sont pas destinées à être implémentées par le code utilisateur. Les seules interfaces que vous pouvez directement implémenter ont des noms qui commencent par la lettre I, tels que ISmartTagExtension.

Toutes les interfaces qui ne commencent pas par la lettre I sont implémentées en interne par Visual Studio 2010 Tools pour Bureau runtime, et ces interfaces peuvent changer dans les versions ultérieures. Pour créer des objets qui implémentent ces interfaces, utilisez les méthodes fournies par l'objet Globals.Factory dans votre projet. Par exemple, pour obtenir un objet qui implémente l'interface SmartTag, utilisez la méthode Globals.Factory.CreateSmartTag. Pour plus d’informations sur Globals.Factory, consultez l’accès global aux objets dans Bureau projets.

Activer l’équivalence de type et les types incorporés dans les projets qui ciblent .NET Framework 4 ou version ultérieure

Étant donné que le modèle objet des extensions Bureau pour .NET Framework 4 ou version ultérieure est basé sur des interfaces, vous pouvez utiliser la fonctionnalité d’équivalence de type dans Visual C# et Visual Basic dans Visual Studio pour incorporer des informations de type à partir du runtime Visual Studio Tools pour Office dans votre solution. Cette fonctionnalité permet Bureau solutions et le runtime Visual Studio Tools pour Office de version indépendamment les uns des autres. Par exemple, si votre solution utilise l'interface Document comme un type incorporé et que la version suivante du runtime ajoute des membres à l'interface Document , votre solution fonctionnera encore avec la version suivante du runtime. Si votre solution n'utilise pas l'interface Document comme un type incorporé, votre solution ne fonctionnera plus avec la version suivante du runtime.

Par défaut, la fonctionnalité d’équivalence de type n’est pas activée lorsque vous créez un projet Bureau qui cible le .NET Framework 4 ou une version ultérieure. Si vous souhaitez activer cette fonction, affectez à la propriété Incorporer les types interop de chacune des références d'assembly suivantes dans votre projet la valeur True:

  • Microsoft.Office.Tools.dll

  • Microsoft.Office.Tools.Common.dll

  • Microsoft.Office.Tools.Excel.dll

  • Microsoft.Office.Tools.Outlook.dll

  • Microsoft.Office.Tools.Word.dll

    Une fois que vous avez apporté cette modification, les informations de type pour tous les types au moment de l'exécution utilisés par le projet sont incorporées dans l'assembly de solution lorsque vous générez le projet. Ces informations de type incorporées, plutôt que les informations de type dans les assemblys référencés, sont utilisées par la solution au moment de l'exécution.

Comprendre le chargeur de solution Bureau

Le runtime Visual Studio Tools pour Office inclut plusieurs DLL non managées que les applications Office utilisent pour charger le runtime et les solutions Office. Bien que vous ne devriez jamais avoir à utiliser directement ces DLL, le fait de savoir à quoi elles servent peut vous aider à mieux comprendre l'architecture des solutions Office.

Pour plus d’informations sur l’utilisation de ces composants pendant le processus de chargement, consultez Architecture des personnalisations au niveau du document et Architecture des compléments VSTO.

vstoee.dll

Lorsqu’un utilisateur ouvre une personnalisation au niveau du document ou démarre un complément VSTO, l’application Office lication appelle vsTOEE.dll pour effectuer les tâches requises pour charger le runtime Visual Studio Tools pour Office.

VSTOEE.dll vérifie que la version correcte du runtime Visual Studio Tools pour Office est chargée pour la solution et la version installée de Bureau. Bien que plusieurs versions du runtime Visual Studio Tools pour Office puissent être installées sur le même ordinateur, une seule instance de VSTOEE.dll est installée à la fois. Il s’agit de VSTOEE.dll qui a été inclus avec la dernière version du runtime installée sur l’ordinateur. Pour plus d’informations sur les différentes versions du runtime Visual Studio Tools pour Office qui peuvent être utilisées pour d’autres solutions, consultez Exécuter des solutions dans différentes versions de Microsoft Bureau.

VSTOLoader.dll

Une fois que VSTOEE.dll charge la version appropriée du runtime Visual Studio Tools pour Office, VSTOLoader.dll effectue la plupart du travail nécessaire pour charger l’assembly de solution. VSTOLoader.dll effectue plusieurs opérations :

  • Il crée un domaine d'application pour chaque assembly de solution.

  • Il exécute un ensemble de vérifications de sécurité pour s'assurer que l'exécution de l'assembly de la solution est autorisée.

  • Il charge la version des extensions Office pour la version .NET Framework requise par la solution.

    VSTOLoader.dll effectue également plusieurs opérations spécifiques aux compléments VSTO :

  • Implémente l'interface IDTExtensibility2 . IDTExtensibility2 est une interface COM que tous les compléments VSTO pour les applications Microsoft Office doivent implémenter. Cette interface définit les méthodes que l’application appelle pour communiquer avec le complément VSTO.

  • Il implémente l’interface IManagedAddin. Cette interface est utilisée par des application Office lications pour faciliter le chargement des compléments VSTO. Pour plus d’informations, consultez l’interface IManagedAddin.

Comprendre les versions 32 bits et 64 bits du runtime

Il existe des versions 64 bits et 32 bits distinctes des outils Visual Studio 2010 pour Bureau runtime. Ces versions du runtime sont utilisées pour exécuter des solutions dans les éditions 64 bits et 32 bits d'Office. Le tableau suivant affiche la version requise du runtime pour chaque combinaison de Windows et d'Office.

Édition de Windows Édition de Microsoft Office Version obligatoire du runtime de Visual Studio Tools pour Office.
32 bits 32 bits 32 bits
64 bits 32 bits 64 bits
64 bits 64 bits 64 bits

Lorsque vous installez Bureau, la version requise du runtime Visual Studio Tools pour Office est installée avec Bureau. Par exemple, lorsque vous installez l’édition 64 bits de Bureau sur une version 64 bits de Windows, la version 64 bits du runtime Visual Studio Tools pour Office est également installée. Pour plus d’informations sur l’installation du runtime Visual Studio Tools pour Office avec Bureau, consultez Visual Studio Tools pour Office scénarios d’installation du runtime.

La version 64 bits d'Office peut également exécuter des solutions Office créées à l'aide de modèles de projet pour la version 2007 de Microsoft Office System dans Visual Studio 2008. Toutefois, il ne peut pas exécuter des solutions Office créées en utilisant des modèles de projet pour Microsoft Office 2003 dans Visual Studio 2008, ou des solutions Office créées à l'aide de Visual Studio 2005. Pour plus d’informations, consultez Exécuter des solutions dans différentes versions de Microsoft Bureau.

Réparer les outils Visual Studio 2010 pour Bureau runtime

Si vous devez réparer le runtime, ouvrez Programmes et fonctionnalités ou Ajout/Suppression de programmes dans le Panneau de configuration, sélectionnez Microsoft Visual Studio 2010 Tools pour Office Runtime dans la liste des programmes, puis cliquez sur Désinstaller. Le programme d'installation qui s'exécute vous permet de réparer le runtime. Si vous cliquez sur Modifier, vous n'aurez pas la possibilité de réparer le runtime.

Contenu connexe