Compartir a través de

Ensamblados de interoperabilidad primarios de Office

Para usar las características de una aplicación de Microsoft Office desde un proyecto de Office, debe usar el ensamblado de interoperabilidad primario (PIA) para la aplicación. El PIA permite que el código administrado interactúe con el modelo de objetos basado en COM de una aplicación de Microsoft Office.

Nota:

¿Le interesa desarrollar soluciones que amplíen la experiencia de Office en varias plataformas? Consulte el nuevo modelo de complementos de Office. Los complementos de Office tienen una huella pequeña en comparación con los complementos y soluciones de VSTO, y puede compilarles mediante casi cualquier tecnología web, como HTML5, JavaScript, CSS3 y XML.

Al crear un nuevo proyecto de Office, Visual Studio agrega referencias a las PIAs necesarias para compilar el proyecto. En algunos escenarios, es posible que tenga que agregar referencias a otros PIA (por ejemplo, puede usar una característica de Microsoft Office Word en un proyecto para Microsoft Office Excel).

En este artículo se describen los siguientes aspectos del uso de piAs de Microsoft Office en proyectos de Office:

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

Separar los ensamblajes de interoperabilidad primarios para compilar y ejecutar proyectos

Visual Studio usa diferentes conjuntos de PIA en el equipo de desarrollo. Estos diferentes conjuntos de ensamblados se encuentran en las siguientes ubicaciones:

  • Una carpeta en el directorio de archivos de programa

    Este conjunto de ensamblados se usa al escribir código y compilar proyectos. Visual Studio instala estos ensamblados automáticamente.

  • Caché global de ensamblaje

    Este conjunto de ensamblados se usa durante algunas tareas de desarrollo, como al ejecutar o depurar proyectos. Visual Studio no instala ni registra estos ensamblados; tienes que hacerlo tú mismo.

Ensamblados de interoperabilidad primarios en el directorio de archivos de programa

Los PIAs se agregan automáticamente a una ubicación en el sistema de archivos, fuera del caché global de ensamblados, durante la instalación de Visual Studio. Al crear un nuevo proyecto, Visual Studio agrega automáticamente referencias a estas copias de los PIA al proyecto. Visual Studio usa estas copias de los PIA, en lugar de los ensamblados de la caché global de ensamblados, para resolver las referencias de tipo al desarrollar y compilar el proyecto.

Cuando se registran diferentes versiones de las PIA en la caché global de ensamblados, puede encontrarse con varios problemas de desarrollo. Las copias añadidas de PIAs le ayudarán a evitar estos problemas.

Para Visual Studio 2017 y versiones posteriores, estas copias de los PIA se instalan en las siguientes ubicaciones compartidas en el equipo de desarrollo:

  • %ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\

  • (o %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ en sistemas operativos de 64 bits)

Nota:

Para versiones anteriores de Visual Studio, estos PIAs se instalarán en la carpeta Visual Studio Tools para Office\PIA dentro de la carpeta %ProgramFiles% correspondiente a esa versión de Visual Studio. Por ejemplo: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Ensamblados de interoperabilidad principales en la caché global de ensamblados

Para realizar determinadas tareas de desarrollo, los PIA deben instalarse y registrarse en la caché global de ensamblados en el equipo de desarrollo. Normalmente, los PIA se instalan automáticamente al instalar 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 son necesarios en equipos de usuario final para ejecutar soluciones de Office. Para obtener más información, consulte Diseño y creación de soluciones de Office.

Uso de características de varias aplicaciones de Microsoft Office en un solo proyecto

Todas las plantillas de proyecto de Office de Visual Studio están diseñadas para trabajar con una sola aplicación de Microsoft Office. Para usar características en varias aplicaciones de Microsoft Office o para usar características en una aplicación o componente que no tiene un proyecto en Visual Studio, debe agregar una referencia a los PIA necesarios.

En la mayoría de los casos, debe agregar referencias a los PIA instalados por Visual Studio en el %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ directorio . Estas versiones de los ensamblados aparecen en la pestaña Marco del cuadro de diálogo Administrador de referencias . Para obtener más información, vea Cómo: Dirigir aplicaciones de Office a través de ensamblados de interoperabilidad primarios.

Si ha instalado y registrado los PIA en la caché global de ensamblados, estas versiones de los ensamblados aparecen en la pestaña COM del cuadro de diálogo Administrador de referencias . Evite agregar referencias a estas versiones de los ensamblados, ya que hay algunos problemas de desarrollo que pueden producirse al usarlos. Por ejemplo, si ha registrado versiones diferentes de los PIA en la caché global de ensamblados, el proyecto se enlazará automáticamente a la versión del ensamblado que se registró por última vez, incluso si especifica una versión diferente del ensamblado en la pestaña COM del cuadro de diálogo Administrador de referencias .

Nota:

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

Ensamblados de interoperabilidad principales para aplicaciones de Microsoft Office

En la tabla siguiente se enumeran los ensamblados de interoperabilidad principales que están disponibles para Office 2016, Office 2013 y Office 2010.


Aplicación o componente de Office Nombre del ensamblado de interoperabilidad principal
Biblioteca de objetos de Microsoft Access 14.0

Biblioteca de objetos de Microsoft Access 15.0		 Microsoft.Office.Interop.Access.dll
Biblioteca de objetos del motor de base de datos de Access de Microsoft Office 14.0

Biblioteca de objetos del motor de base de datos de Access de Microsoft Office 15.0		 Microsoft.Office.Interop.Access.Dao.dll
Biblioteca de objetos de Microsoft Excel 14.0

Biblioteca de objetos de Microsoft Excel 15.0		 Microsoft.Office.Interop.Excel.dll
Biblioteca de objetos de Microsoft Graph 14.0 (usada por PowerPoint, Access y Word para grafos)

Biblioteca de objetos de Microsoft Graph 15.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 14.0 (funcionalidad compartida de Office)

Biblioteca de objetos de Microsoft Office 15.0 (funcionalidad compartida de Office)		 office.dll
Control de vistas de Microsoft Office Outlook (se puede usar en páginas web y aplicaciones para acceder a la Bandeja de entrada) Microsoft.Office.Interop.OutlookViewCtl.dll
Biblioteca de objetos de Microsoft Outlook 14.0

Biblioteca de objetos de Microsoft Outlook 15.0		 Microsoft.Office.Interop.Outlook.dll
Biblioteca de objetos de Microsoft PowerPoint 14.0

Biblioteca de objetos de Microsoft PowerPoint 15.0		 Microsoft.Office.Interop.PowerPoint.dll
Biblioteca de objetos de Microsoft Project 14.0

Biblioteca de objetos de Microsoft Project 15.0		 Microsoft.Office.Interop.MSProject.dll
Biblioteca de objetos de Microsoft Publisher 14.0

Biblioteca de objetos de Microsoft Publisher 15.0		 Microsoft.Office.Interop.Publisher.dll
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 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Microsoft Smart Tags 2.0 Type Library Nota: Las etiquetas inteligentes están en desuso en Excel 2010 y Word 2010. Microsoft.Office.Interop.SmartTag.dll
Biblioteca de tipos de Microsoft Visio 14.0

Biblioteca de tipos de Microsoft Visio 15.0		 Microsoft.Office.Interop.Visio.dll
Microsoft Visio 14.0 Guardar como biblioteca de tipos web

Microsoft Visio 15.0 Guardar como biblioteca de tipos web		 Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Biblioteca de tipos de control para dibujos de Microsoft Visio 14.0

Biblioteca de tipos de control de dibujo de Microsoft Visio 15.0		 Microsoft.Office.Interop.VisOcx.dll
Biblioteca de objetos de Microsoft Word 14.0

Biblioteca de objetos de Microsoft Word 15.0		 Microsoft.Office.Interop.Word.dll
Extensibilidad 5.3 de Microsoft Visual Basic para aplicaciones Microsoft.Vbe.Interop.dll

Enlaces de ensamblados de redirección

Al instalar y registrar los PIA de Office en la caché global de ensamblados (ya sea con Office o instalando el paquete redistribuible para los PIA), los ensamblados de redirección de enlace también se instalan únicamente en la caché global de ensamblados. Estos ensamblados garantizan que la versión correcta de los ensamblados de interoperabilidad principales se cargue en tiempo de ejecución.

Por ejemplo, cuando una solución que hace referencia a un ensamblado de Office 2010 se ejecuta en un equipo que tiene la versión de Office 2013 del mismo ensamblado de interoperabilidad principal, el ensamblado de redirección de enlace indica al entorno de ejecución de .NET Framework que cargue la versión de Office 2013 del ensamblado de interoperabilidad principal.

Para obtener más información, vea Cómo: Habilitar y deshabilitar el redireccionamiento automático de enlaces.

Contenido relacionado

  • Last updated on