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 los ensamblados se utilizan durante algunas tareas de desarrollo, como ejecutar o depurar proyectos para .NET Framework 3.5. 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 equipos de usuario final también deben tener PIA instalados y registrados en la caché global de ensamblados para ejecutar soluciones de Office para .NET Framework 3.5. Sin embargo, no es necesario instalar los PIA de Office en los equipos de los usuarios finales para ejecutar soluciones de Office destinadas a .NET Framework 4. 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 Microsoft 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 .gif "Nota") Nota
Las etiquetas inteligentes están desusadas en Excel 2010 y Word 2010.Para obtener más información, vea Información general sobre etiquetas inteligentes.
|
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 Microsoft 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 Microsoft 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
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