Introducción al entorno de ejecución de Visual Studio Tools para Office

  • Artículo

Para ejecutar soluciones creadas mediante las herramientas de desarrollo de Microsoft Office en Visual Studio, el entorno de ejecución de Visual Studio 2010 Tools para Office debe instalarse en equipos de usuario final. Para obtener más información, consulte How to: Install the Visual Studio Tools para Office runtime redistributable(Cómo: Instalar el entorno de ejecución redistribuible de Visual Studio Tools para Office). El entorno de ejecución de Visual Studio 2010 Tools para Office consta de dos componentes principales:

  • Las extensiones de Office para .NET Framework. Estos componentes son ensamblados administrados que proporcionan la capa de comunicación entre la solución y la aplicación de Microsoft Office. Para obtener más información, consulte Descripción de las extensiones de Office para .NET Framework.

  • El cargador de solución de Office. Este componente es un conjunto de DLL no administradas que las aplicaciones de Office usan para cargar el runtime y las soluciones. Para obtener más información, consulte Descripción del cargador de soluciones de Office.

    El runtime se puede instalar de varias maneras diferentes. Dependiendo de la configuración del equipo, se instalan distintos componentes en tiempo de ejecución al instalar el runtime. Para obtener más información, consulte Visual Studio Tools para Office escenarios de instalación en tiempo de ejecución.

Descripción de las extensiones de Office para .NET Framework

El entorno de ejecución de Visual Studio 2010 Tools para Office incluye extensiones de Office para .NET Framework 3.5, .NET Framework 4 y versiones posteriores. Las soluciones destinadas a cada versión de .NET Framework usan las extensiones correspondientes para esa versión.

Estas extensiones están formadas por ensamblados que las soluciones usan para automatizar y extender las aplicaciones de Office. Al crear un proyecto de Office, Visual Studio agrega automáticamente las referencias a los ensamblados correspondientes al tipo de proyecto y la versión de .NET Framework de destino del proyecto. Para obtener más información sobre los ensamblados de las extensiones de Office, vea Ensamblados en el entorno de ejecución de Visual Studio Tools para Office.

Diferencias de diseño en las extensiones de Office

La mayoría de los tipos que utiliza en las extensiones de Office para .NET Framework 3.5 son clases. Estas son las mismas clases que se incluyeron en versiones anteriores del entorno de ejecución de Visual Studio Tools para Office . En cambio, la mayoría de los tipos que se usan en las extensiones de Office para .NET Framework 4 o posterior son interfaces. Por ejemplo, cuando el destino es .NET Framework 4 o posterior, los Worksheet tipos y Document son interfaces en lugar de clases.

En la mayoría de los casos, el código que escribe en soluciones de Office es el mismo si la solución tiene como destino .NET Framework 3.5 o .NET Framework 4. Sin embargo, ciertas características requieren código diferente para cada versión de .NET Framework. Para obtener más información, consulte Migración de soluciones de Office a .NET Framework 4 o posterior.

Interfaces de las extensiones de Office para .NET Framework 4 o posterior

La mayoría de las interfaces de las extensiones de Office para .NET Framework 4 o posterior no están diseñadas para implementarse mediante código de usuario. Las únicas interfaces que puede implementar directamente tienen nombres que comienzan por la letra I, como ISmartTagExtension.

Todas las interfaces que no comienzan con la letra que se implementan internamente en visual Studio 2010 Tools para Office Runtime, y estas interfaces pueden cambiar en futuras versiones. Para crear objetos que implementan estas interfaces, utilice métodos proporcionados por el objeto Globals.Factory en su proyecto. Por ejemplo, para obtener un objeto que implemente la interfaz SmartTag, utilice el método Globals.Factory.CreateSmartTag. Para obtener más información sobre Globals.Factory, vea Acceso global a objetos en proyectos de Office.

Habilitar la equivalencia de tipos y los tipos incrustados en proyectos que tienen como destino .NET Framework 4 o posterior

Dado que el modelo de objetos de las extensiones de Office para .NET Framework 4 o posterior se basan en interfaces, puede usar la característica de equivalencia de tipos en Visual C# y Visual Basic en Visual Studio para insertar información de tipos desde el entorno de ejecución de Visual Studio Tools para Office en la solución. Esta característica permite que las soluciones de Office y el entorno de ejecución de Visual Studio Tools para Office se versione independientemente entre sí. Por ejemplo, si su solución utiliza la interfaz Document como tipo incrustado y la versión siguiente del runtime agrega miembros a la interfaz Document , la solución seguirá funcionando con la versión siguiente del runtime. Si la solución no utiliza la interfaz Document como tipo incrustado, entonces la solución ya no funcionará con la versión siguiente del runtime.

De forma predeterminada, la característica de equivalencia de tipos no está habilitada al crear un proyecto de Office destinado a .NET Framework 4 o posterior. Si desea habilitar esta característica, establezca la propiedad Incrustar tipos de interoperabilidad de cualquiera de las siguientes referencias de ensamblado del proyecto en 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

    Después de realizar esta modificación, la información de tipo para todos los tipos en tiempo de ejecución utilizados por el proyecto se incrusta en el ensamblado de la solución al compilar el proyecto. La solución utiliza esta información de tipo incrustada en tiempo de ejecución, en lugar de la información de tipo de los ensamblados a los que se hace referencia.

Descripción del cargador de soluciones de Office

El Runtime de Microsoft Visual Studio Tools para Office incluye varias DLL no administradas que las aplicaciones de Office usan para cargar el runtime y las soluciones de Office. Aunque nunca debería tener que trabajar directamente con estas DLL, conocer su finalidad puede ayudarle a entender mejor la arquitectura de las soluciones de Office.

Para obtener información sobre cómo se usan estos componentes durante el proceso de carga, vea Arquitectura de personalizaciones de nivel de documento y Arquitectura de complementos de VSTO.

vstoee.dll

Cuando un usuario abre una personalización de nivel de documento o inicia un complemento de VSTO, la aplicación de Office lication llama a VSTOEE.dll para realizar las tareas necesarias para cargar el entorno de ejecución de Visual Studio Tools para Office .

VSTOEE.dll garantiza que se cargue la versión correcta del entorno de ejecución de Visual Studio Tools para Office para la solución y la versión instalada de Office. Aunque se pueden instalar varias versiones del entorno de ejecución de Visual Studio Tools para Office en el mismo equipo, solo se instala una instancia de VSTOEE.dll a la vez. Este es el archivo VSTOEE.dll que se incluyó con la versión más reciente del entorno de ejecución instalado en el equipo. Para obtener más información sobre las distintas versiones del entorno de ejecución de Visual Studio Tools para Office que se pueden usar para otras soluciones, vea Ejecutar soluciones en distintas versiones de Microsoft Office.

VSTOLoader.dll

Después de que VSTOEE.dll cargue la versión adecuada del entorno de ejecución de Visual Studio Tools para Office , VSTOLoader.dll realiza la mayor parte del trabajo necesario para cargar el ensamblado de la solución. VSTOLoader.dll hace varias cosas:

  • Crea un dominio de aplicación para cada ensamblado de solución.

  • Realiza un conjunto de comprobaciones de seguridad para comprobar que el ensamblado de solución tiene permiso para ejecutarse.

  • Carga la versión de las extensiones de Office para .NET Framework que requiere la solución.

    VSTOLoader.dll también realiza varias cosas específicas de los complementos de VSTO:

  • Implementa la interfaz IDTExtensibility2 . IDTExtensibility2 es una interfaz COM que deben implementar todos los complementos de VSTO para aplicaciones de Microsoft Office. Esta interfaz define métodos a los que la aplicación llama para comunicar con el complemento de VSTO.

  • Implementa la interfaz IManagedAddin. Esta interfaz la usan aplicación de Office lications para ayudar a cargar complementos de VSTO. Para obtener más información, vea Interfaz IManagedAddin.

Descripción de las versiones de 32 y 64 bits del entorno de ejecución

Hay versiones independientes de 64 y 32 bits de Visual Studio 2010 Tools para Office runtime. Estas versiones del runtime se utilizan para ejecutar soluciones en las ediciones de 64 bits y de 32 bits de Office. La siguiente tabla muestra qué versión del runtime es necesaria para cada combinación de Windows y Office.

Edición de Windows Edición de Microsoft Office Versión obligatoria de Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office
32 bits 32 bits 32 bits
64 bits 32 bits 64 bits
64 bits 64 bits 64 bits

Al instalar Office, la versión necesaria del entorno de ejecución de Visual Studio Tools para Office se instala junto con Office. Por ejemplo, al instalar la edición de 64 bits de Office en una versión de 64 bits de Windows, también se instala la versión de 64 bits del entorno de ejecución de Visual Studio Tools para Office. Para obtener más información sobre cómo instalar el entorno de ejecución de Visual Studio Tools para Office con Office, consulte Visual Studio Tools para Office escenarios de instalación en tiempo de ejecución.

La versión de 64 bits de Office también puede ejecutar soluciones de Office creadas con plantillas de proyecto de 2007 Microsoft Office system en Visual Studio 2008. Sin embargo, no puede ejecutar soluciones de Office creadas con plantillas de proyecto para Microsoft Office 2003 en Visual Studio 2008 o soluciones de Office creadas con Visual Studio 2005. Para obtener más información, vea Ejecutar soluciones en diferentes versiones de Microsoft Office.

Reparación del entorno de ejecución de Visual Studio 2010 Tools para Office

Si necesita reparar el runtime, abra Programas y características o Agregar o quitar programas en el Panel de control, seleccione Runtime de Microsoft Visual Studio 2010 Tools para Office en la lista de programas y, a continuación, haga clic en Desinstalar. El programa de instalación que se ejecuta permite reparar el runtime. Si hace clic en Cambiar, no tendrá la opción de reparar el runtime.

Contenido relacionado