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

Artículo
02/19/2013

Para ejecutar soluciones creadas con las herramientas de desarrollo de Microsoft Office en Visual Studio 2012, Visual Studio 2010 Tools para Office Runtime se debe instalar en equipos de usuario final.Visual Studio 2010 Tools para Office Runtime 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, vea Introducción a 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, vea Introducción al cargador de solución 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, vea Escenarios de instalación del Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

Introducción a las extensiones de Office para .NET Framework

Visual Studio 2010 Tools para Office Runtime incluye las extensiones de Office para .NET Framework 3.5, .NET Framework 4, y .NET Framework 4.5.Soluciones destinadas a cada versión de.NET Framework las extensiones adecuadas 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 en las extensiones de Office, vea Ensamblados en el Motor en tiempo de ejecución de Microsoft 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.Son las mismas clases que se incluían en versiones anteriores de Runtime de Microsoft Visual Studio Tools para Office. En cambio, la mayoría de los tipos que se utilizan en las extensiones de Office para .NET Framework 4 y .NET Framework 4.5 son interfaces.Por ejemplo, cuando el destino es .NET Framework 4 o .NET Framework 4.5, Microsoft.Office.Tools.Excel.Worksheet y los tipos de Microsoft.Office.Tools.Word.Document son interfaces en lugar de clases.

En la mayoría de los casos, el código que se escribe en las soluciones de Office es el mismo con independencia de si la versión de destino de la solución es .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, vea Migrar soluciones de Office a .NET Framework 4 o .NET Framework 4.5.

Interfaces de las extensiones de Office para .NET Framework 4 y .NET Framework 4.5

La mayoría de las interfaces de las extensiones de Office para .NET Framework 4 y .NET Framework 4.5 no se implementan 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 por la letra I se implementan internamente por 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 los proyectos de Office.

Habilitar la equivalencia de tipos y tipos incrustados en proyectos destinados a.NET Framework 4 y .NET Framework 4.5

Dado que el modelo de objetos de las extensiones de Office para .NET Framework 4 y .NET Framework 4.5 se basa en las interfaces, puede utilizar la característica de equivalencia de tipos en Visual c# y Visual Basic en Visual Studio 2012 para incrustar información de tipo de Runtime de Microsoft Visual Studio Tools para Office en la solución. Esta característica permite que las soluciones de Office y Runtime de Microsoft Visual Studio Tools para Office a la versión independiente entre sí.Por ejemplo, si su solución utiliza la interfaz Microsoft.Office.Tools.Word.Document como tipo incrustado y la versión siguiente del runtime agrega miembros a la interfaz Microsoft.Office.Tools.Word.Document, la solución seguirá funcionando con la versión siguiente del runtime.Si la solución no utiliza la interfaz Microsoft.Office.Tools.Word.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 cuando se crea un proyecto de Office destinado a .NET Framework 4 o .NET Framework 4.5.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.

Introducción al cargador de solución de Office

El runtime de 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 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.

VSTOEE.dll

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

VSTOEE.dll se asegura de que se carga la versión correcta de Runtime de Microsoft Visual Studio Tools para Office para la solución y la versión instalada de Office.Si bien en el equipo se pueden instalar varias versiones de Runtime de Microsoft Visual Studio Tools para Office, no se instala más de 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.Para obtener más información sobre las distintas versiones de Runtime de Microsoft Visual Studio Tools para Office que se pueden usar para otras soluciones, vea Ejecutar soluciones en diferentes versiones de Microsoft Office.

VSTOLoader.dll

Después de que VSTOEE.dll carga la versión adecuada de Runtime de Microsoft Visual Studio Tools para Office, VSTOLoader.dll realiza la mayoría del trabajo necesario para cargar el ensamblado de la solución.VSTOLoader.dll realiza varias acciones:

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 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.Las aplicaciones de Office usan esta interfaz para ayudar a cargar los complementos de nivel de aplicación.Para obtener más información, vea Interfaz IManagedAddin.

Introducción a las versiones de 32 bits y de 64 bits del runtime

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

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 2013 o Office 2010, la versión necesaria de Runtime de Microsoft Visual Studio Tools para Office junto con Office se instala.Por ejemplo, al instalar la edición de 64 bits de Office 2013 o de Office 2010 en una versión de 64 bits de Windows, la versión de 64 bits de Runtime de Microsoft Visual Studio Tools para Office también está instalada.Para obtener más información sobre cómo instalar Runtime de Microsoft Visual Studio Tools para Office con Office 2013 o Office 2010, vea Escenarios de instalación del Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

La versión de 64 bits de Office 2013 o de Office 2010 puede ejecutar soluciones de Office creadas con plantillas de proyecto para 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.

Reparar Visual Studio 2010 Tools para Office Runtime

Si necesita reparar el runtime, abra Programas y características o Agregar o quitar programas en el Panel de control, seleccione Microsoft Visual Studio 2010 Tools para Office Runtime 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.

Vea también

Compartir a través de