Partager via

Vue d’ensemble de Visual Studio Tools pour Office Runtime

Pour exécuter des solutions créées à l’aide des outils de développement Microsoft Office dans Visual Studio, les outils Visual Studio 2010 pour Office runtime doivent être installés sur les ordinateurs des utilisateurs finaux. Pour plus d’informations, consultez Guide pratique pour installer Visual Studio Tools pour Office runtime redistribuable. Le runtime Visual Studio 2010 Tools pour Office se compose de deux composants principaux :

Comprendre les extensions Office pour .NET Framework

Visual Studio 2010 Tools pour Office runtime inclut des extensions Office 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 d’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 le .NET Framework cible du projet. Pour plus d’informations sur les assemblys dans les extensions Office, consultez Assemblys dans Visual Studio Tools pour Office runtime.

Différences de conception dans les extensions Office

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 de Visual Studio Tools pour Office runtime . En revanche, la plupart des types que vous utilisez dans les extensions Office pour .NET Framework 4 ou version ultérieure sont des interfaces. Par exemple, lorsque vous ciblez le .NET Framework 4 ou une version ultérieure, les types Worksheet et Document sont des interfaces plutôt que des classes.

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

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

La plupart des interfaces des extensions Office 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 implémenter ont directement des noms qui commencent par la lettre I, par ISmartTagExtensionexemple.

Toutes les interfaces qui ne commencent pas par la lettre I sont implémentées en interne par visual Studio 2010 Tools for Office runtime, et ces interfaces peuvent changer dans les versions ultérieures. Pour créer des objets qui implémentent ces interfaces, utilisez des 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 Globals.Factory.CreateSmartTag méthode. Pour plus d’informations sur Globals.Factory, consultez l’accès global aux objets dans les projets Office.

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 Office 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 aux solutions Office et au runtime Visual Studio Tools pour Office de se versionner indépendamment les uns des autres. Par exemple, si votre solution utilise l’interface Document comme type incorporé et que la version suivante du runtime ajoute des membres à l’interface Document , votre solution fonctionne toujours avec la prochaine version du runtime. Si votre solution n’utilise pas l’interface Document comme type incorporé, votre solution ne fonctionnera plus avec la prochaine version du runtime.

Par défaut, la fonctionnalité d’équivalence de type n’est pas activée lorsque vous créez un projet Office qui cible le .NET Framework 4 ou une version ultérieure. Si vous souhaitez activer cette fonctionnalité, définissez la propriété Embed Interop Types de l’une des références d’assembly suivantes dans votre projet sur 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

    Après avoir apporté cette modification, les informations de type pour tous les types d’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 Office

Le runtime Visual Studio Tools pour Office comprend plusieurs DLL non managées utilisées par les applications Office pour charger le runtime et les solutions Office. Bien que vous n’ayez jamais à travailler directement avec ces DLL, connaître les objectifs de ces DLL 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 appelle VSTOEE.dll pour effectuer les tâches requises pour charger visual Studio Tools pour Office runtime.

VSTOEE.dll vérifiez que la version correcte du runtime Visual Studio Tools pour Office est chargée pour la solution et la version installée d’Office. 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 la VSTOEE.dll qui a été incluse 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 Office.

VSTOLoader.dll

Après 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 effectue un ensemble de vérifications de sécurité pour vérifier que l’assembly de solution est autorisé à s’exécuter.

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

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

  • Il 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 les applications Office 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 Office 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 indique la version du runtime requise pour chaque combinaison de Windows et d’Office.

Édition de Windows Édition de Microsoft Office Version requise du runtime Visual Studio Tools pour Office
32 bits 32 bits 32 bits
64-bit 32 bits 64-bit
64-bit 64-bit 64-bit

Lorsque vous installez Office, la version requise de Visual Studio Tools pour Office runtime est installée avec Office. Par exemple, lorsque vous installez l’édition 64 bits d’Office 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 de Visual Studio Tools pour Office runtime avec Office, consultez les scénarios d’installation de Visual Studio Tools pour Office.

La version 64 bits d’Office peut également exécuter des solutions Office créées à l’aide de modèles de projet pour Microsoft Office System 2007 dans Visual Studio 2008. Toutefois, il ne peut pas exécuter de solutions Office créées à l’aide de modèles de projet pour Microsoft Office 2003 dans Visual Studio 2008 ou de 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 Office.

Réparer les outils de Visual Studio 2010 pour l'environnement d'exécution Office

Si vous devez réparer le runtime, ouvrez Programmes et fonctionnalités ou Ajouter ou supprimer des programmes dans le Panneau de configuration, sélectionnez Microsoft Visual Studio 2010 Tools for 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’avez pas la possibilité de réparer le runtime.

Contenu connexe

  • Last updated on