assembly di interoperabilità primari di Office

Per usare le funzionalità di un'applicazione di Microsoft Office di un progetto di Office è necessario usare l'assembly di interoperabilità primario (PIA) per l'applicazione. L'assembly di interoperabilità primario consente l'interazione tra il codice gestito e il modello a oggetti basati su COM di un'applicazione di Microsoft Office.

Nota

Si è interessati allo sviluppo di soluzioni che estendono l'esperienza di Office tra più piattaforme? Vedere il nuovo modello di componenti aggiuntivi per Office. I componenti aggiuntivi di Office hanno un footprint ridotto rispetto ai componenti aggiuntivi e alle soluzioni VSTO ed è possibile compilarli usando quasi qualsiasi tecnologia di programmazione Web, ad esempio HTML5, JavaScript, CSS3 e XML.

Quando si crea un nuovo progetto di Office, Visual Studio aggiunge riferimenti agli assembly di interoperabilità primari che sono necessari per compilare il progetto. In alcuni scenari potrebbe essere necessario aggiungere riferimenti ad altri PIA( ad esempio, è possibile usare una funzionalità di Microsoft Office Word in un progetto per Microsoft Office Excel).

Questo articolo descrive gli aspetti seguenti dell'uso delle applicazioni personali di Microsoft Office nei progetti di Office:

Per altre informazioni sugli assembly di interoperabilità primari, vedere Assembly di interoperabilità primari.

Separare gli assembly di interoperabilità primari per compilare ed eseguire progetti

Visual Studio usa diversi set di assembly di interoperabilità primari sul computer di sviluppo, che si trovano nei seguenti percorsi:

  • Cartella nella directory dei file di programma

    Questo set di assembly viene usato quando si scrivono progetti di codice e compilazione. Visual Studio installa automaticamente questi assembly.

  • Global Assembly Cache

    Questo set di assembly viene usato durante alcune attività di sviluppo, ad esempio quando si eseguono o si esegue il debug di progetti. Visual Studio non installa e registra questi assembly; devi farlo da solo.

Assembly di interoperabilità primari nella directory dei file di programma

I piA vengono aggiunti automaticamente a un percorso nel file system, all'esterno della Global Assembly Cache, durante l'installazione di Visual Studio. Quando si crea un nuovo progetto, Visual Studio aggiunge automaticamente al progetto riferimenti a queste copie degli assembly di interoperabilità primari. Visual Studio usa queste copie degli assembly di interoperabilità primari invece che degli assembly nella Global Assembly Cache, per risolvere i riferimenti ai tipi quando si sviluppa e si compila il progetto.

Quando diverse versioni dei piA vengono registrate nella Global Assembly Cache, è possibile riscontrare diversi problemi di sviluppo. Le copie aggiunte di informazioni personali consentono di evitare tali problemi.

Per Visual Studio 2017 e versioni successive, queste copie degli account personali vengono installate nei percorsi condivisi seguenti nel computer di sviluppo:

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

  • (o %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ nei sistemi operativi a 64 bit)

Nota

Per le versioni precedenti di Visual Studio, questi PIA verranno installati nella cartella Strumenti di Visual Studio per Office\PIA nella %ProgramFiles% cartella per tale versione di Visual Studio. Per esempio: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Assembly di interoperabilità primari nella Global Assembly Cache

Per eseguire determinate attività di sviluppo, gli assembly di interoperabilità primari devono essere installati e registrati nella Global Assembly Cache sul computer di sviluppo. Di solito, gli assembly di interoperabilità primari vengono installati automaticamente quando si installa Office sul computer di sviluppo. Per altre informazioni, vedere Configurare un computer per sviluppare soluzioni Office.

Le applicazioni personali di Office non sono necessarie nei computer degli utenti finali per eseguire soluzioni Office. Per altre informazioni, vedere Progettare e creare soluzioni Office.

Usare le funzionalità di più app Office licazioni Microsoft in un singolo progetto

Ogni modello di progetto di Office in Visual Studio è progettato per funzionare con una singola applicazione di Microsoft Office. Per usare le funzionalità in più app Office licazioni Microsoft o per usare le funzionalità in un'applicazione o in un componente che non dispone di un progetto in Visual Studio, è necessario aggiungere un riferimento ai piA necessari.

Nella maggior parte dei casi, è necessario aggiungere riferimenti ai piA installati da Visual Studio nella %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ directory . Queste versioni degli assembly vengono visualizzate nella scheda Framework della finestra di dialogo Gestione riferimenti. Per altre informazioni, vedere Procedura: Impostare come destinazione app Office licazioni tramite assembly di interoperabilità primari.

Se sono stati installati e registrati i piA nella Global Assembly Cache, queste versioni degli assembly vengono visualizzate nella scheda COM della finestra di dialogo Gestione riferimenti. Evitare di aggiungere riferimenti a queste versioni degli assembly, perché esistono alcuni problemi di sviluppo che possono verificarsi quando vengono usati. Ad esempio, se sono state registrate versioni diverse dei piA nella Global Assembly Cache, il progetto verrà associato automaticamente alla versione dell'assembly registrato per ultimo, anche se si specifica una versione diversa dell'assembly nella scheda COM della finestra di dialogo Gestione riferimenti.

Nota

Alcuni assembly vengono aggiunti automaticamente a un progetto quando si aggiunge un assembly che vi fa riferimento. Ad esempio, i riferimenti agli Office.dll assembly e Microsoft.Vbe.Interop.dll vengono aggiunti automaticamente quando si aggiunge un riferimento agli assembly Word, Excel, Outlook, Microsoft Forms o Graph.

Assembly di interoperabilità primari per microsoft app Office licazioni

La tabella seguente elenca gli assembly di interoperabilità principali disponibili per Office 2016, Office 2013 e Office 2010.


Applicazione o componente di Office Nome dell'assembly di interoperabilità primario
Libreria oggetti di Microsoft Access 14.0

Libreria oggetti di Microsoft Access 15.0
Microsoft.Office.Interop.Access.dll
Libreria oggetti del modulo di gestione di database di Access di Microsoft Office 14.0

Libreria oggetti del modulo di gestione di database di Access di Microsoft Office 15.0
Microsoft.Office.Interop.Access.Dao.dll
Libreria oggetti di Microsoft Excel 14.0

Libreria oggetti di Microsoft Excel 15.0
Microsoft.Office.Interop.Excel.dll
Libreria oggetti di Microsoft Graph 14.0 (usata da PowerPoint, Access e Word per i grafici)

Libreria oggetti di Microsoft Graph 15.0
Microsoft.Office.Interop.Graph.dll
Libreria dei tipi Microsoft InfoPath 2.0 (solo per InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Assembly di interoperabilità XML di Microsoft InfoPath (solo per InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
Libreria oggetti Microsoft Office 14.0 (funzionalità condivisa di Office)

Libreria oggetti Microsoft Office 15.0 (funzionalità condivisa di Office)
office.dll
Microsoft Office Outlook - Controllo visualizzazione (può essere usato in applicazioni e pagine Web per accedere alla cartella Posta in arrivo) Microsoft.Office.Interop.OutlookViewCtl.dll
Libreria oggetti di Microsoft Outlook 14.0

Libreria oggetti di Microsoft Outlook 15.0
Microsoft.Office.Interop.Outlook.dll
Libreria oggetti di Microsoft PowerPoint 14.0

Libreria oggetti di Microsoft PowerPoint 15.0
Microsoft.Office.Interop.PowerPoint.dll
Libreria oggetti di Microsoft Project 14.0

Libreria oggetti di Microsoft Project 15.0
Microsoft.Office.Interop.MSProject.dll
Libreria oggetti di Microsoft Publisher 14.0

Libreria oggetti di Microsoft Publisher 15.0
Microsoft.Office.Interop.Publisher.dll
Libreria riferimenti a oggetti Web di Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesigner.dll
Libreria riferimenti a oggetti pagina di Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Nota della libreria dei tipi di Microsoft Smart Tags 2.0: gli smart tag sono deprecati in Excel 2010 e Word 2010. Microsoft.Office.Interop.SmartTag.dll
Libreria dei tipi Microsoft Visio 14.0

Libreria dei tipi Microsoft Visio 15.0
Microsoft.Office.Interop.Visio.dll
Libreria dei tipi Salva come pagina Web Microsoft Visio 14.0

Libreria dei tipi Salva come pagina Web Microsoft Visio 15.0
Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Libreria dei tipi controlli disegno di Microsoft Visio 14.0

Libreria dei tipi controlli disegno di Microsoft Visio 15.0
Microsoft.Office.Interop.VisOcx.dll
Libreria oggetti di Microsoft Word 14.0

Libreria oggetti di Microsoft Word 15.0
Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic, Applications Edition Extensibility 5.3 Microsoft.Vbe.Interop.dll

Associazione di assembly di reindirizzamento

Quando si installano e registrano gli assembly di interoperabilità primari di Office nella Global Assembly Cache (tramite Office o installando il pacchetto ridistribuibile per gli assembly di interoperabilità primari), gli assembly di reindirizzamento delle associazioni sono anche installati solo nella Global Assembly Cache. Questi assembly assicurano che la versione corretta degli assembly di interoperabilità primari venga caricata in fase di esecuzione.

Ad esempio, quando una soluzione che fa riferimento a un assembly di Office 2010 viene eseguita in un computer con la versione di Office 2013 dello stesso assembly di interoperabilità primario, l'assembly di reindirizzamento dell'associazione indica al runtime di .NET Framework di caricare la versione di Office 2013 dell'assembly di interoperabilità primario.

Per altre informazioni, vedere Procedura: Abilitare e disabilitare il reindirizzamento automatico dell'associazione.