Información general sobre el motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office

Artículo
04/28/2010

Actualización: noviembre 2007

Para ejecutar soluciones creadas con Visual Studio Tools para Office, los equipos de usuario final deben tener instalado el motor en tiempo de ejecución de Visual Studio Tools para Office. El motor en tiempo de ejecución incluye ensamblados administrados que proporcionan la capa de comunicación entre la solución y la aplicación de Microsoft Office, así como componentes no administrados que la aplicación utiliza para cargar la solución.

Para obtener información sobre cómo instalar el motor en tiempo de ejecución en equipos de usuario final, vea Cómo: Instalar el motor en tiempo de ejecución para Visual Studio Tools para Office.

En este tema se proporciona la información siguiente:

Descripción de las diferentes versiones del motor en tiempo de ejecución
Descripción de los ensamblados en tiempo de ejecución
Descripción de los componentes de cargador en tiempo de ejecución

Descripción de las diferentes versiones del motor en tiempo de ejecución

Las soluciones de Visual Studio Tools para Office para las diferentes versiones de Microsoft Office requieren versiones diferentes del motor en tiempo de ejecución. La versión del motor en tiempo de ejecución se determina mediante la plantilla de proyecto utilizada para crear la solución, no mediante la versión de Office que ejecuta la solución.

En la tabla siguiente se muestran las versiones del motor en tiempo de ejecución y de Microsoft Office necesarias para ejecutar soluciones en el equipo del usuario final.

Versión de la plantilla de proyecto	Versión del motor en tiempo de ejecución de Visual Studio Tools para Office necesaria en el equipo del usuario final	Versiones de Microsoft Office que pueden ejecutar la solución en el equipo del usuario final
Proyectos para Microsoft Office System 2007	Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime)	Microsoft Office System 2007
Proyectos para Microsoft Office 2003	Visual Studio 2005 Tools para Office Second Edition runtime	Microsoft Office System 2007 Microsoft Office 2003

Versión de la plantilla de proyecto

Versión del motor en tiempo de ejecución de Visual Studio Tools para Office necesaria en el equipo del usuario final

Versiones de Microsoft Office que pueden ejecutar la solución en el equipo del usuario final

Proyectos para Microsoft Office System 2007

Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime)

Microsoft Office System 2007

Proyectos para Microsoft Office 2003

Visual Studio 2005 Tools para Office Second Edition runtime

Microsoft Office System 2007

Microsoft Office 2003

Ambas versiones del motor en tiempo de ejecución se instalan automáticamente en el equipo de desarrollo al instalar Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0).

Para obtener información sobre cómo crear soluciones que se pueden ejecutar con ambas versiones de Microsoft Office, vea Crear soluciones para varias versiones de Microsoft Office.

Hay algunas diferencias entre los ensamblados incluidos en cada versión del motor en tiempo de ejecución. Para obtener más información, vea Diferencias de ensamblado.

Nota:
Visual Studio 2005 Tools para Office Second Edition runtime se lanzó inicialmente con Microsoft Visual Studio 2005 Tools para Microsoft Office System 2007 (VSTO 2005 SE). Las soluciones para Microsoft Office 2003 que se crean mediante Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0) también utilizan esta versión del motor en tiempo de ejecución.

Buscar documentación de referencia para ambos motores en tiempo de ejecución

Al hacer clic en un vínculo o una entrada de índice en la Ayuda para obtener información acerca de un espacio de nombres, un tipo o un miembro, podría obtener dos resultados prácticamente idénticos. Los dos temas documentan los mismos miembros en las dos versiones del motor en tiempo de ejecución. Seleccione el tema que se identifica mediante el indicador de versión adecuado:

Sistema 2007. Hace referencia a Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime).
Sistema 2003. Hace referencia a Visual Studio 2005 Tools para Office Second Edition runtime.

Descripción de los ensamblados en tiempo de ejecución

Los ensamblados incluidos en el motor en tiempo de ejecución de Visual Studio Tools para Office proporcionan las categorías siguientes de clases:

Clases que la solución utiliza para automatizar y extender la aplicación host.
Clases de infraestructura que permiten a la solución comunicarse con la aplicación host.

Nota:
Al crear un proyecto, Visual Studio Tools para Office agrega automáticamente las referencias a los ensamblados que se utilizan para el tipo de proyecto. Algunos de los ensamblados sólo se utilizan en proyectos de nivel de documento y otros sólo se utilizan en proyectos de nivel de aplicación.

Ensamblados en Visual Studio Tools para Office 3.0 Runtime

En la tabla siguiente se enumeran los ensamblados incluidos en Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime). Esta versión del motor de ejecución se utiliza en soluciones creadas para Microsoft Office System 2007.

Para tener acceso a documentación sobre los espacios de nombres y las clases de estos ensamblados, vea Referencia administrada de 2007 System.

Nombre del ensamblado	Description
Microsoft.Office.Tools.Common.v9.0.dll	Proporciona las clases siguientes: La clase base AddIn para complementos en el nivel de aplicación. Clases para crear paneles de acciones y etiquetas inteligentes en personalizaciones en el nivel de documento. Clases para crear paneles de tareas personalizados en complementos en el nivel de aplicación. Clases para crear personalizaciones en la cinta de opciones. Las clases ExcelLocale1033Attribute y ExcelLocale1033Proxy, que utilizan las soluciones de Excel para controlar el identificador de configuración regional (LCID) que se usa en todas las llamadas al modelo de objetos de Excel sensibles a la configuración regional. Para obtener más información, consulte Aplicar formato a datos de Excel con varias configuraciones regionales.
Microsoft.Office.Tools.Excel.v9.0.dll	Proporciona elementos y controles host para personalizaciones en el nivel de documento de Excel. Para obtener más información, consulte Información general sobre elementos y controles Host.
Microsoft.Office.Tools.Outlook.v9.0.dll	Proporciona clases que puede utilizar para crear áreas de formulario personalizadas en complementos de Outlook.
Microsoft.Office.Tools.Word.v9.0.dll	Proporciona elementos y controles host para personalizaciones en el nivel de documento de Word. Para obtener más información, consulte Información general sobre elementos y controles Host.
Microsoft.Office.Tools.v9.0.dll	Proporciona las clases siguientes: La clase RemoteBindableComponent, que proporciona las funciones de enlace de datos para los controles host en personalizaciones en el nivel de documento. Otras clases que forman parte de la infraestructura de Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime) y no están diseñadas para usarlas directamente en el código.
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll	Proporciona las clases siguientes: El atributo CachedAttribute y las clases ICachedType, que puede utilizar para almacenar en memoria caché los objetos de datos de una personalización en el nivel de documento. Excepciones que puede iniciar el motor de tiempo de ejecución de Visual Studio Tools para Office. Otras clases que forman parte de la infraestructura de Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime) y no están diseñadas para usarlas directamente en el código.
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll	Proporciona las clases siguientes: La clase ServerDocument, que puede utilizar para asociar mediante programación los ensamblados de personalización a los documentos y para tener acceso a los datos almacenados en memoria caché en documentos. Varias clases que representan la jerarquía de los datos almacenados en memoria caché en una personalización en el nivel de documento.
Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll	Proporciona las clases siguientes: Las clases AddInSecurityEntry y UserInclusionList, que puede utilizar para crear entradas de la lista de inclusión del usuario y conceder así confianza a una solución de Visual Studio Tools para Office para Microsoft Office System 2007. Para obtener más información, vea Otorgar confianza a las soluciones de Office mediante listas de inclusión (2007 System). Otras clases que forman parte de la infraestructura de Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime) y no están diseñadas para usarlas directamente en el código.
Microsoft.VisualStudio.Tools.Office.AppInfoDocument.v9.0.dll Microsoft.VisualStudio.Tools.Office.Contract.v9.0.dll	Proporciona clases que forman parte de la infraestructura de Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime). Estas clases no están pensadas para utilizarlas directamente en el código.

Ensamblados en Visual Studio 2005 Tools para Office Second Edition Runtime

En la tabla siguiente se enumeran los ensamblados incluidos en Visual Studio 2005 Tools para Office Second Edition runtime. Esta versión del motor de ejecución se utiliza en soluciones creadas para Microsoft Office System 2003.

Para tener acceso a documentación sobre los espacios de nombres y las clases de estos ensamblados, vea Referencia administrada de 2003 System.

Nombre del ensamblado	Description
Microsoft.Office.Tools.Common.dll	Proporciona las clases siguientes: La clase base AddIn para complementos en el nivel de la aplicación. Clases para crear paneles de acciones y etiquetas inteligentes en personalizaciones en el nivel de documento.
Microsoft.Office.Tools.Excel.dll	Proporciona elementos y controles host para personalizaciones en el nivel de documento de Excel. Para obtener más información, consulte Información general sobre elementos y controles Host.
Microsoft.Office.Tools.Word.dll	Proporciona elementos y controles host para personalizaciones en el nivel de documento de Word. Para obtener más información, consulte Información general sobre elementos y controles Host.
Microsoft.VisualStudio.Tools.Applications.Runtime.dll	Proporciona las clases siguientes: La clase ServerDocument, que puede utilizar para asociar mediante programación las personalizaciones a los documentos y para tener acceso a los datos almacenados en memoria caché en documentos. El atributo CachedAttribute y las clases ICachedType, que puede utilizar para almacenar en memoria caché los objetos de datos de una personalización en el nivel de documento. Excepciones que puede iniciar el motor de tiempo de ejecución de Visual Studio Tools para Office. Otras clases que forman parte de la infraestructura de Visual Studio 2005 Tools para Office Second Edition runtime y no están diseñadas para usarlas directamente en el código.

Diferencias de ensamblado

Varios ensamblados incluidos en Visual Studio 2005 Tools para Office Second Edition runtime tienen nombres diferentes en Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime). Además, un ensamblado que forma parte de Visual Studio 2005 Tools para Office Second Edition runtime se ha dividido en varios ensamblados nuevos en Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime).

En la tabla siguiente se indican las diferencias.

Nombre del ensamblado en Visual Studio 2005 Tools para Office Second Edition runtime	Nombre del ensamblado en Microsoft Visual Studio Tools para Microsoft Office System (versión 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 Algunas clases también se han movido a los nuevos ensamblados siguientes: Microsoft.Office.Tools.v9.0.dll Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll

Descripción de los componentes de cargador en tiempo de ejecución

El motor en tiempo de ejecución de Visual Studio Tools para Office incluye varias DLL no administradas que las aplicaciones de Microsoft Office utilizan para cargar soluciones de Visual Studio Tools para 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 Visual Studio Tools para Office.

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

Cargador en tiempo de ejecución

Cuando un usuario abre una personalización en el nivel de documento o inicia un complemento, la aplicación de Microsoft Office realiza una llamada en el cargador en tiempo de ejecución. Este componente se denomina VSTOEE.dll.

El cargador en tiempo de ejecución garantiza que se carga la versión correcta del motor en tiempo de ejecución de Visual Studio Tools para Office correspondiente a la versión de Microsoft Office que carga el complemento. Si bien en el equipo se pueden instalar varias versiones del motor en tiempo de ejecución de Visual Studio Tools para Office, sólo se instala una instancia de VSTOEE.dll a la vez. Esta versión corresponde al archivo VSTOEE.dll incluido con la última versión del motor en tiempo de ejecución instalado en el equipo.

Cargador de la solución

El cargador de la solución realiza la mayoría del trabajo necesario para cargar el ensamblado de la solución. El cargador de la solución tiene nombres de archivo diferentes, en función de la versión del motor en tiempo de ejecución de Visual Studio Tools para Office. El cargador de la solución en Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 Runtime) se denomina VSTOLoader.dll. En Visual Studio 2005 Tools para Office Second Edition runtime, se denomina AddinLoader.dll.

El cargador de la solución hace varias cosas:

Crea un nuevo dominio de aplicación para cada ensamblado de solución de Visual Studio Tools para Office.
Realiza un conjunto de comprobaciones de seguridad para comprobar que el ensamblado de complemento tiene permiso para ejecutarse.

El cargador de la solución también realiza varias tareas específicas de los complementos:

Implementa la interfaz IDTExtensibility2. IDTExtensibility2 es una interfaz COM que deben implementar todos los complementos para aplicaciones de Microsoft Office. Esta interfaz define métodos a los que la aplicación llama para comunicar con el complemento.
Implementa la interfaz IManagedAddin. A partir de la versión 2007, las aplicaciones de Office utilizan esta interfaz para ayudar a cargar los complementos de Visual Studio Tools para Office. Para obtener más información, consulte Interfaz IManagedAddin.

Vea también

Share via