ensamblados de interoperabilidad primarios de Office

  • Artículo

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) de 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 superficie pequeña en comparación con los complementos y soluciones de VSTO, y puede compilarlos mediante casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.

Al crear un proyecto de Office, Visual Studio agrega referencias a los PIA obligatorios 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 ensamblados de interoperabilidad primarios para compilar y ejecutar proyectos

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

  • 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 ensamblados

    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 PIA se agregan automáticamente a una ubicación en el sistema de archivos, fuera de la caché global de ensamblados, mientras instala Visual Studio. Al crear un 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 referencias a tipos al desarrollar y compilar el proyecto.

Cuando se registran diferentes versiones de los PIA en la caché global de ensamblados, puede enfrentar varios problemas de desarrollo. Las copias agregadas 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 PIA se instalarán en la carpeta Visual Studio Tools para Office\PIA en la %ProgramFiles% carpeta de 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 ciertas tareas de desarrollo, los PIA deben estar instalados y registrados en la caché global de ensamblados del 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 aplicación de Office licaciones de Microsoft en un solo proyecto

Cada plantilla de proyecto de Office en Visual Studio está diseñada para funcionar con una sola aplicación de Microsoft Office. Para usar características en varias aplicación de Office licaciones de Microsoft 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 How to: Target aplicación de Office lications through primary interop assemblies.

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 a un proyecto automáticamente cuando se agrega un ensamblado que hace referencia a ellos. Por ejemplo, las referencias a los Office.dll ensamblados y Microsoft.Vbe.Interop.dll se agregan automáticamente al agregar una referencia a los ensamblados word, Excel, Outlook, Microsoft Forms o Graph.

Ensamblados de interoperabilidad principales para Microsoft aplicación de Office lications

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 primario
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 gráficos)

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 tener acceso 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
Biblioteca de tipos Guardar como web de Microsoft Visio 14.0

Biblioteca de tipos Guardar como web de Microsoft Visio 15.0		 Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Biblioteca de tipos de control de dibujo 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 de Microsoft Visual Basic para Aplicaciones 5.3 Microsoft.Vbe.Interop.dll

Enlaces de ensamblados de redirección

Al instalar y registrar los PIA de Office en la caché global de ensamblados (con Office o por medio de la instalación del paquete redistribuible para los PIA), los ensamblados de redirección de enlace también se instalan solamente 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