Compartir a través de

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

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, vea How to: Install the Visual Studio Tools for Office runtime redistributable. El entorno de ejecución de Visual Studio 2010 Tools para Office consta de dos componentes principales:

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 que tienen como destino cada versión de .NET Framework usan las extensiones adecuadas para esa versión.

Estas extensiones constan de ensamblados que las soluciones usan para automatizar y ampliar las aplicaciones de Office. Al crear un proyecto de Office, Visual Studio agrega automáticamente referencias a los ensamblados que se usan para el tipo de proyecto y el .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 se usan 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, algunas características requieren código diferente cuando se tienen como destino versiones diferentes 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 I se implementan internamente en el entorno de ejecución de Visual Studio 2010 Tools para Office, y estas interfaces pueden cambiar en futuras versiones. Para crear objetos que implementen estas interfaces, use los métodos proporcionados por el objeto Globals.Factory en su proyecto. Por ejemplo, para obtener un objeto que implemente la SmartTag interfaz, use el Globals.Factory.CreateSmartTag método . 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 basa 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 tipo 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 la solución usa la Document interfaz como un tipo incrustado y la siguiente versión del entorno de ejecución agrega miembros a la Document interfaz, la solución seguirá funcionando con la siguiente versión del entorno de ejecución. Si la solución no usa la Document interfaz como un tipo incrustado, la solución ya no funcionará con la siguiente versión del entorno de ejecución.

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 este cambio, la información de tipos de todos los tipos utilizados en tiempo de ejecución por el proyecto se integra en el ensamblado de la solución cuando se compila el proyecto. Esta información de tipo incrustada, en lugar de la información de tipo de los ensamblados referenciados, se utiliza por la solución en tiempo de ejecución.

Entender el cargador de soluciones de Office

El entorno de ejecución de Visual Studio Tools para Office incluye varios archivos DLL no administrados que las aplicaciones de Office usan para cargar el entorno de ejecución y las soluciones de Office. Aunque nunca debe tener que trabajar directamente con estos archivos DLL, conocer los propósitos de estos archivos DLL puede ayudarle a comprender 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 llama a VSTOEE.dll para realizar las tareas necesarias para cargar el entorno de ejecución de Visual Studio Tools para Office.

VSTOEE.dll se asegura de 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 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 VSTOEE.dll carga 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 la solución tiene permiso para ejecutarse.

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

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

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

  • Implementa la interfaz IManagedAddin. Las aplicaciones de Office usan esta interfaz 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 bits y 32 bits del entorno de ejecución de Herramientas para Office de Visual Studio 2010. Estas versiones del entorno de ejecución se usan para ejecutar soluciones en ediciones de 64 y 32 bits de Office. En la tabla siguiente se muestra qué versión del entorno de ejecución es necesaria para cada combinación de Windows y Office.

Edición de Windows Edición de Microsoft Office Versión requerida del runtime de Visual Studio Tools para Office
32 bits 32 bits 32 bits
64-bit 32 bits 64-bit
64-bit 64-bit 64-bit

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, vea Escenarios de instalación en tiempo de ejecución de Visual Studio Tools para Office.

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

Reparar las Herramientas de Visual Studio 2010 para Office en el entorno de ejecución

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

Contenido relacionado

  • Last updated on