Ensamblados de interoperabilidad primarios de Office

Artículo
10/07/2008

Actualización: noviembre 2007

Para usar las características de una aplicación de Microsoft Office en un proyecto de Visual Studio Tools para Office, debe utilizar el ensamblado de interoperabilidad primario de esa aplicación. Los ensamblados de interoperabilidad primarios permiten que el código administrado interactúe con el modelo de objetos basado en COM de una aplicación de Office.

Al crear un nuevo proyecto de Visual Studio Tools para Office, Visual Studio agrega referencias a los ensamblados de interoperabilidad primarios que resultan necesarios para generar el proyecto. En algunos escenarios, es posible que necesite agregar referencias a otros ensamblados de interoperabilidad primarios (por ejemplo, si desea utilizar una característica de Microsoft Office Word en un proyecto de Microsoft Office Excel).

En este tema se describen los aspectos siguientes del uso de ensamblados de interoperabilidad primarios de Microsoft Office:

Ensamblados de interoperabilidad primarios diferentes para la compilación y ejecución de proyectos
Utilizar características de varias aplicaciones de Microsoft Office en un único proyecto
Ensamblados de interoperabilidad primarios de Microsoft Office 2003
Ensamblados de interoperabilidad primarios de 2007 Microsoft Office system

Para obtener más información sobre los ensamblados de interoperabilidad primarios, vea Ensamblados de interoperabilidad primario.

Ensamblados de interoperabilidad primarios diferentes para la compilación y ejecución de proyectos

Visual Studio Tools para Office utiliza conjuntos diferentes de ensamblados de interoperabilidad primarios en el equipo de desarrollo. Estos conjuntos de ensamblados se encuentran en las ubicaciones siguientes:

Una carpeta del directorio Archivos de programa.

Estas copias de los ensamblados se utilizan cuando se escribe código y se generan proyectos. Visual Studio Tools para Office instala automáticamente estos ensamblados.
La caché de ensamblados global.

Estas copias de los ensamblado se utilizan cuando se ejecutan o depuran proyectos. Visual Studio Tools para Office no instala ni registra estos ensamblados; debe hacerlo usted mismo.

Ensamblados de interoperabilidad primarios del directorio Archivos de programa

Al instalar Visual Studio Tools para Office, los ensamblados de interoperabilidad primarios se instalan automáticamente en una ubicación del sistema de archivos, fuera de la memoria caché de ensamblados global. Cuando crea un nuevo proyecto, Visual Studio Tools para Office agrega automáticamente referencias a estas copias de los ensamblados de interoperabilidad primarios en el proyecto. Visual Studio Tools para Office utiliza estas copias de los ensamblados de interoperabilidad primarios, en lugar de los ensamblados de la memoria caché de ensamblados global, para resolver las referencias de tipo que surgen al desarrollar y generar el proyecto.

Estas copias de los ensamblados de interoperabilidad primarios ayudan a Visual Studio Tools para Office a evitar algunos problemas de desarrollo que pueden producirse cuando en la memoria caché de ensamblados global están registradas las versiones 2003 y 2007 de los ensamblados de interoperabilidad primarios de Office.

Visual Studio Tools para Office instala estas copias de los ensamblados de interoperabilidad primarios en las siguientes ubicaciones del equipo de desarrollo:

%Archivos de programa%\Microsoft Visual Studio 9.0\Visual Studio Tools for Office\PIA\Office11
%Archivos de programa%\Microsoft Visual Studio 9.0\Visual Studio Tools for Office\PIA\Office12

Ensamblados de interoperabilidad primarios de la memoria caché de ensamblados global

Para realizar la mayoría de las tareas de desarrollo, debe instalar y registrar los ensamblados de interoperabilidad primarios en la memoria caché de ensamblados global. Para ello, realice una instalación completa de Microsoft Office o instale el paquete redistribuible de los ensamblados de interoperabilidad primarios. Para obtener más información, consulte Cómo: Instalar ensamblados de interoperabilidad primario de Office.

Los ensamblados de interoperabilidad primarios deben estar instalados y registrados en la memoria caché de ensamblados global para poder realizar las tareas de desarrollo siguientes:

Crear un proyecto de personalización de nivel de documento.
Ejecutar o depurar cualquier proyecto de Visual Studio Tools para Office.

En los equipos de los usuarios finales, los ensamblados de interoperabilidad primarios también deben estar instalados y registrados en la memoria caché de ensamblados globales para poder ejecutar las soluciones de Visual Studio Tools para Office.

Utilizar características de varias aplicaciones de Microsoft Office en un único proyecto

Cada plantilla de proyecto de Visual Studio Tools para Office está diseñada para trabajar con una única aplicación de Microsoft Office. Para utilizar características de varias aplicaciones de Microsoft Office o para utilizar las características de una aplicación o componente que no tiene un proyecto en Visual Studio Tools para Office, debe agregar una referencia a los ensamblados de interoperabilidad primarios correspondientes.

En la mayoría de los casos, deberá agregar referencias a los ensamblados de interoperabilidad primarios que están instalados en Visual Studio Tools para Office en el directorio %Archivos de programa%. Estas versiones de los ensamblados aparecen en la ficha .NET del cuadro de diálogo Agregar referencia. Para obtener más información, consulte Cómo: Apuntar a las aplicaciones de Office mediante los ensamblados de interoperabilidad primarios.

Si ha instalado y registrado los ensamblados de interoperabilidad primarios en la memoria caché de ensamblados global, estas versiones de los ensamblados aparecen en la ficha COM del cuadro de diálogo Agregar referencia. No conviene que agregue referencias a estas versiones de los ensamblados porque podrían surgir algunos problemas de desarrollo al utilizarlas. Por ejemplo, si ha registrado las versiones 2003 y 2007 de los ensamblados de interoperabilidad primarios en la memoria caché de ensamblados global, el proyecto se enlazará automáticamente a la versión del ensamblado que se registró en último lugar (aunque especificara una versión diferente del ensamblado en la ficha COM del cuadro de diálogo Agregar referencia).

Nota:
Algunos ensamblados se agregan automáticamente a los proyectos cuando se incluye un ensamblado que hace referencia a ellos. Por ejemplo, las referencias a los ensamblados Office.dll y Microsoft.Vbe.Interop.dll se agregan automáticamente cuando se agrega una referencia a los ensamblados de Word, Excel, Outlook, Microsoft Forms o Graph.

Ensamblados de interoperabilidad primarios de Microsoft Office 2003

En la tabla siguiente se muestran los ensamblados de interoperabilidad primarios que están disponibles para Microsoft Office 2003.

Aplicación o componente de Office	Nombre del ensamblado de interoperabilidad primario
Biblioteca de objetos de Microsoft Access 11.0	Microsoft.Office.Interop.Access.dll
Biblioteca de objetos de Microsoft Excel 11.0	Microsoft.Office.Interop.Excel.dll
Biblioteca de referencia de objetos Web de Microsoft FrontPage 6.0	Microsoft.Office.Interop.Frontpage.dll
Biblioteca de referencia de objetos de página de Microsoft FrontPage 6.0	Microsoft.Office.Interop.Frontpageeditor.dll
Biblioteca de objetos de Microsoft Graph 11.0 (utilizada por PowerPoint, Access y Word para gráficos)	Microsoft.Office.Interop.Graph.dll
Biblioteca de objetos de Microsoft Outlook 11.0	Microsoft.Office.Interop.Outlook.dll
Control de vista de Microsoft Outlook (se puede utilizar en páginas Web y aplicaciones para tener acceso a la bandeja de entrada)	Microsoft.Office.Interop.OutlookViewCtl.dll
Microsoft Office Web Components 11.0 (hoja de cálculo, gráfico y tabla dinámica de páginas Web)	Microsoft.Office.Interop.owc11.dll
Biblioteca de objetos de Microsoft PowerPoint 11.0	Microsoft.Office.Interop.PowerPoint.dll
Biblioteca de objetos de Microsoft Project 11.0	Microsoft.Office.Interop.MSProject.dll
Biblioteca de objetos de Microsoft Publisher 11.0	Microsoft.Office.Interop.Publisher.dll
Biblioteca de tipos de Microsoft Smart Tags 2.0	Microsoft.Office.Interop.SmartTag.dll
Biblioteca de objetos de Microsoft Word 11.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic para extensibilidad de aplicaciones 5.3	Microsoft.Vbe.Interop.dll
Biblioteca de objetos de Microsoft Forms 2.0 (controles programables que se pueden utilizar en las aplicaciones)	Microsoft.Vbe.Interop.Forms.dll
Biblioteca de objetos de Microsoft Office 11.0 (funciones compartidas de Office)	office.dll

Ensamblados de interoperabilidad primarios de 2007 Microsoft Office system

En la tabla siguiente se muestran los ensamblados de interoperabilidad primarios que están disponibles para 2007 Microsoft Office system.

Aplicación o componente de Office	Nombre del ensamblado de interoperabilidad primario
Biblioteca de objetos de Microsoft Access 12.0	Microsoft.Office.Interop.Access.dll
Biblioteca de objetos del motor de base de datos de Microsoft Office Access 2007	Microsoft.Office.Interop.Access.Dao.dll
Biblioteca de objetos de Microsoft Excel 12.0	Microsoft.Office.Interop.Excel.dll
Biblioteca de objetos de Microsoft Graph 12.0 (utilizada por PowerPoint, Access y Word para gráficos)	Microsoft.Office.Interop.Graph.dll
Biblioteca de tipos de Microsoft InfoPath 2.0	Microsoft.Office.Interop.InfoPath.dll
Ensamblado de interoperabilidad XML de Microsoft InfoPath	Microsoft.Office.Interop.InfoPath.Xml.dll
Biblioteca de objetos de Microsoft Outlook 12.0	Microsoft.Office.Interop.Outlook.dll
Control de vista de Microsoft Office Outlook (se puede utilizar en páginas Web y aplicaciones para tener acceso a la bandeja de entrada)	Microsoft.Office.Interop.OutlookViewCtl.dll
Biblioteca de objetos de Microsoft PowerPoint 12.0	Microsoft.Office.Interop.PowerPoint.dll
Biblioteca de objetos de Microsoft Project 12.0	Microsoft.Office.Interop.MSProject.dll
Biblioteca de objetos de Microsoft Publisher 12.0	Microsoft.Office.Interop.Publisher.dll
Biblioteca de referencia de objetos Web de Microsoft SharePointDesigner 12.0	Microsoft.Office.Interop.SharePointDesigner.dll
Biblioteca de referencia de objetos de página de Microsoft SharePointDesigner 12.0	Microsoft.Office.Interop.SharePointDesignerPage.dll
Biblioteca de tipos de Microsoft Smart Tags 2.0	Microsoft.Office.Interop.SmartTag.dll
Biblioteca de tipos de Microsoft Visio 12.0	Microsoft.Office.Interop.Visio.dll
Biblioteca de tipos Guardar como Web de Microsoft Visio 12.0	Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Biblioteca de tipos de control de dibujo de Microsoft Visio 12.0	Microsoft.Office.Interop.VisOcx.dll
Biblioteca de objetos de Microsoft Word 12.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic para extensibilidad de aplicaciones 5.3	Microsoft.Vbe.Interop.dll
Biblioteca de objetos de Microsoft Office 12.0 (funciones compartidas de Office)	office.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Access	Policy.11.0.Microsoft.Office.Interop.Access.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Excel	Policy.11.0.Microsoft.Office.Interop.Excel.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Graph	Policy.11.0.Microsoft.Office.Interop.Graph.dll
Ensamblado de redirección de enlaces para la biblioteca de tipos de Microsoft InfoPath	Policy.11.0.Microsoft.Office.Interop.InfoPath.dll
Ensamblado de redirección de enlaces para el ensamblado de interoperabilidad XML de Microsoft InfoPath	Policy.11.0.Microsoft.Office.Interop.InfoPath.Xml.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Outlook	Policy.11.0.Microsoft.Office.Interop.Outlook.dll
Ensamblado de redirección de enlaces para el control de vista de Microsoft Outlook	Policy.11.0.Microsoft.Office.Interop.OutlookViewCtl.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft PowerPoint	Policy.11.0.Microsoft.Office.Interop.PowerPoint.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Project	Policy.11.0.Microsoft.Office.Interop.MSProject.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Publisher	Policy.11.0.Microsoft.Office.Interop.Publisher.dll
Ensamblado de redirección de enlaces para la biblioteca de tipos de Microsoft Smart Tags	Policy.11.0.Microsoft.Office.Interop.SmartTag.dll
Biblioteca de tipos de Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.Visio.dll
Ensamblado de redirección de enlaces de la biblioteca de tipos Guardar como Web de Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Ensamblado de redirección de enlaces de la biblioteca de tipos de control de dibujo de Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.VisOcx.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Word	Policy.11.0.Microsoft.Office.Interop.Word.dll
Ensamblado de redirección de enlaces para Microsoft Visual Basic para extensibilidad de aplicaciones 5.3	Policy.11.0.Microsoft.Vbe.Interop.dll
Ensamblado de redirección de enlaces para la biblioteca de objetos de Microsoft Office	Policy.11.0.office.dll

Nota:
Los ensamblados de redirección de enlaces ayudan a garantizar que la versión de Microsoft Office 2007 de los ensamblados de interoperabilidad primarios se cargue en tiempo de ejecución. Cuando una solución de Visual Studio Tools para Office que hace referencia a un ensamblado de interoperabilidad primario de Microsoft Office 2003 se ejecuta en un equipo que tiene la versión de Microsoft Office 2007 de dicho ensamblado, el ensamblado de redirección de enlaces indica al motor en tiempo de ejecución de .NET Framework que cargue la versión de Microsoft Office 2007 del ensamblado de interoperabilidad primario. Para obtener más información, vea Redirección del enlace de ensamblados.

Los ensamblados de redirección de enlaces ayudan a garantizar que la versión de Microsoft Office 2007 de los ensamblados de interoperabilidad primarios se cargue en tiempo de ejecución. Cuando una solución de Visual Studio Tools para Office que hace referencia a un ensamblado de interoperabilidad primario de Microsoft Office 2003 se ejecuta en un equipo que tiene la versión de Microsoft Office 2007 de dicho ensamblado, el ensamblado de redirección de enlaces indica al motor en tiempo de ejecución de .NET Framework que cargue la versión de Microsoft Office 2007 del ensamblado de interoperabilidad primario. Para obtener más información, vea Redirección del enlace de ensamblados.

Vea también

Tareas

Cómo: Apuntar a las aplicaciones de Office mediante los ensamblados de interoperabilidad primarios

Otros recursos

Referencia general (Visual Studio Tools para Office)

Compartir a través de