Ensamblados de interoperabilidad primarios de Office

Para usar las características de una aplicación de Microsoft Office en un proyecto de Office, debe utilizar el ensamblado de interoperabilidad primario (PIA) de esa aplicación.El PIA permite al código administrado interactuar con modelos de objetos basados en COM de una aplicación de Microsoft Office.

Al crear un nuevo proyecto de Office, Visual Studio agrega referencias a los PIA que son necesarias para compilar 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 siguientes aspectos del uso de los PIA de Microsoft Office en proyectos de 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

• Lista completa de ensamblados de interoperabilidad primarios de aplicaciones de Microsoft Office

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 utiliza conjuntos de PIA diferentes 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 compilan proyectos.Visual Studio instala estos ensamblados automáticamente.

• La caché global de ensamblados.

  Estas copias de ensamblados se utilizan durante algunas tareas de desarrollo, por ejemplo al ejecutar o depurar proyectos.Visual Studio no instala ni registra estos ensamblados; debe hacerlo usted.

Ensamblados de interoperabilidad primarios del directorio Archivos de programa

Al instalar Visual Studio, los PIA se instalan automáticamente en una ubicación del sistema de archivos, fuera de la caché global de ensamblados.Al crear un nuevo proyecto, Visual Studio agrega automáticamente referencias a estas copias de los PIA a su proyecto.Visual Studio utiliza estas copias de los PIA, en lugar de los ensamblados de la caché global de ensamblados, para resolver las referencias de tipo al desarrollar e compilar su proyecto.

Estas copias de los PIA ayudan a Visual Studio a evitar varios problemas de desarrollo que se pueden producir cuando se registran versiones diferentes de los PIA en la caché global de ensamblados.

Visual Studio instala estas copias de los PIA en las siguientes ubicaciones en el equipo de desarrollo:

• %Archivos de programa%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12

  (o % Archivos de programa(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools para Office\PIA\Office12 en sistemas operativos de 64 bits)

• %Archivos de programa%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office14

  (o % Archivos de programa(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools para Office\PIA\Office14 en sistemas operativos de 64 bits)

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

Para realizar ciertas tareas de desarrollo, los PIA se deben instalar y se registrar en la caché global de ensamblados en el equipo de desarrollo.Normalmente, los PIA se instalan automáticamente cuando se instala Office en el equipo de desarrollo.Para obtener más información, vea Configurar un equipo para desarrollar soluciones de Office.

Los PIA de Office no se requieren en equipos de usuarios finales para ejecutar soluciones de Office.Para obtener más información, vea Diseñar y crear soluciones de Office.

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

Cada plantilla de proyecto de Office en Visual Studio 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, debe agregar una referencia a los ensamblados de interoperabilidad primarios correspondientes.

En la mayoría de los casos, debe agregar referencias a los PIA instalados por Visual Studio en el directorio %Archivos de programa%\Microsoft Visual Studio 10.0\Visual Studio Tools para Office\PIA\.Estas versiones de los ensamblados aparecen en la ficha .NET del cuadro de diálogo Agregar referencia.Para obtener más información, vea 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é global de ensamblados, estas versiones de los ensamblados aparecen en la pestaña 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 diferentes de los ensamblados de interoperabilidad primarios en la memoria caché global de ensamblados, 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 pestaña 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 aplicaciones de Microsoft Office

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

Aplicación o componente de Office	Nombre del ensamblado de interoperabilidad primario
Biblioteca de objetos de Microsoft Access 12.0 Biblioteca de objetos de Microsoft Access 14.0	Microsoft.Office.Interop.Access.dll
Biblioteca de objetos del motor de base de datos de Microsoft Office Access 2007 Biblioteca de objetos del motor de base de datos de Microsoft Office Access 14.0	Microsoft.Office.Interop.Access.Dao.dll
Biblioteca de objetos de Microsoft Excel 12.0 Biblioteca de objetos de Microsoft Excel 14.0	Microsoft.Office.Interop.Excel.dll
Biblioteca de objetos de Microsoft Graph 12.0 (utilizada por PowerPoint, Access y Word para gráficos) Biblioteca de objetos de Microsoft Graph 14.0	Microsoft.Office.Interop.Graph.dll
Biblioteca de tipos de Microsoft InfoPath 2.0 (solo para InfoPath 2007)	Microsoft.Office.Interop.InfoPath.dll
Ensamblado de interoperabilidad XML de Microsoft InfoPath (solo para InfoPath 2007)	Microsoft.Office.Interop.InfoPath.Xml.dll
Biblioteca de objetos de Microsoft Office 12.0 (funciones compartidas de Office) Biblioteca de objetos de Microsoft Office 14.0 (funciones compartidas de Office)	office.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 Outlook 12.0 Biblioteca de objetos de Microsoft Outlook 14.0	Microsoft.Office.Interop.Outlook.dll
Biblioteca de objetos de Microsoft PowerPoint 12.0 Biblioteca de objetos de Microsoft PowerPoint 14.0	Microsoft.Office.Interop.PowerPoint.dll
Biblioteca de objetos de Microsoft Project 12.0 Biblioteca de objetos de Microsoft Project 14.0	Microsoft.Office.Interop.MSProject.dll
Biblioteca de objetos de Microsoft Publisher 12.0 Biblioteca de objetos de Microsoft Publisher 14.0	Microsoft.Office.Interop.Publisher.dll
Biblioteca de referencia de objetos Web de Microsoft SharePoint Designer 12.0 Biblioteca de referencia de objetos Web de Microsoft SharePoint Designer 14.0	Microsoft.Office.Interop.SharePointDesigner.dll
Biblioteca de referencia de objetos de página de Microsoft SharePoint Designer 12.0 Biblioteca de referencia de objetos de página de Microsoft SharePoint Designer 14.0	Microsoft.Office.Interop.SharePointDesignerPage.dll
Biblioteca de tipos de Microsoft Smart Tags 2.0 Nota Las etiquetas inteligentes están desusadas en Excel 2010 y Word 2010.	Microsoft.Office.Interop.SmartTag.dll
Biblioteca de tipos de Microsoft Visio 12.0 Biblioteca de tipos de Microsoft Visio 14.0	Microsoft.Office.Interop.Visio.dll
Biblioteca de tipos Guardar como Web de Microsoft Visio 12.0 Biblioteca de tipos Guardar como Web de Microsoft Visio 14.0	Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Biblioteca de tipos de control de dibujo de Microsoft Visio 12.0 Biblioteca de tipos de control de dibujo de Microsoft Visio 14.0	Microsoft.Office.Interop.VisOcx.dll
Biblioteca de objetos de Microsoft Word 12.0 Biblioteca de objetos de Microsoft Word 14.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic para extensibilidad de aplicaciones 5.3	Microsoft.Vbe.Interop.dll

Enlazar ensamblados de redirección

Al instalar y registrar los PIA de Office en la caché global de ensamblados (con Office o instalando el paquete redistribuible de los PIA), los ensamblados de redirección de enlace también se instalan solo en la caché global de ensamblados.Estos ensamblados ayudan a asegurarse de que se carga la versión correcta de los ensamblados de interoperabilidad primarios en tiempo de ejecución.Por ejemplo, cuando una solución que hace referencia a un ensamblado de interoperabilidad primario de Microsoft Office 2007 se ejecuta en un equipo que tiene la versión de Office 2010 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 Office 2010 del ensamblado de interoperabilidad primario.Para obtener más información, vea Redirección del enlace de ensamblados.

Cada ensamblado de redirección de enlace tiene un nombre en el formato Policy.11.0.Nombre PIA.dll o Policy.12.0.Nombre PIA.dll, como Policy.11.0.Microsoft.Office.Interop.Excel.dll y Policy.12.0.Microsoft.Office.Interop.Excel.dll.

Vea también

Tareas

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

Conceptos

Soluciones de InfoPath

Soluciones de PowerPoint

Soluciones de Project

Información general sobre el modelo de objetos de Visio

Otros recursos

Información general sobre el modelo de objetos de Excel

Información general sobre el modelo de objetos de Outlook

Información general acerca del modelo de objetos de Word

Referencia general (desarrollo de Office en Visual Studio)