Assembly di interoperabilità primari di Office

Per utilizzare le funzionalità di un'applicazione Microsoft Office da un progetto Office è necessario utilizzare l'assembly di interoperabilità primario (PIA) dell'applicazione. L'assembly di interoperabilità primario consente al codice gestito di interagire con un modello a oggetti COM di un'applicazione di Microsoft Office.

Quando si crea un nuovo progetto Office, in Visual Studio vengono aggiunti riferimenti agli assembly di interoperabilità primari necessari per la compilazione del progetto. In alcuni scenari può essere necessario aggiungere riferimenti agli assembly di interoperabilità primari (PIA) aggiuntivi, ad esempio per utilizzare una funzionalità di Microsoft Office Word in un progetto per Microsoft Office Excel.

In questo argomento vengono descritti gli aspetti seguenti dell'utilizzo degli assembly di interoperabilità primari di Microsoft Office nei progetti di Office:

  • Assembly di interoperabilità primari a parte per la compilazione e l'esecuzione di progetti

  • Utilizzo di funzionalità di più applicazioni di Microsoft Office in un unico progetto

  • Elenco completo di assembly di interoperabilità primari per applicazioni Microsoft Office

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

Assembly di interoperabilità primari separati per la compilazione e l'esecuzione di progetti

Visual Studio utilizza set diversi degli assembly di interoperabilità primari sul computer di sviluppo. I vari insiemi di assembly si trovano nei percorsi seguenti:

  • Una cartella nella directory Programmi.

    Tali copie degli assembly vengono utilizzate per la scrittura di codice e la compilazione di progetti. Visual Studio installa automaticamente questi assembly.

  • La Global Assembly Cache.

    Queste copie degli assembly vengono utilizzate durante alcune attività di sviluppo, ad esempio durante l'esecuzione o il debug di progetti destinati a .NET Framework 3.5. Visual Studio non installa e non registra questi assembly; è l'utente che deve farlo.

Assembly di interoperabilità primari nella directory Programmi

Durante l'installazione di Visual Studio, gli assembly di interoperabilità primari vengono installati automaticamente in una posizione del file system, esternamente alla Global Assembly Cache. Quando si crea un nuovo progetto, in Visual Studio vengono aggiunti automaticamente riferimenti a queste copie degli assembly di interoperabilità primari del progetto. Visual Studio utilizza queste copie degli assembly di interoperabilità primari, anziché gli assembly presenti nel Global Assembly Cache, per risolvere i riferimenti di tipo quando si sviluppa e compila il progetto.

Queste copie di assembly di interoperabilità primari consentono a Visual Studio di evitare i diversi problemi di sviluppo che possono verificarsi quando nella Global Assembly Cache vengono registrate versioni diverse di assembly di interoperabilità primari.

Visual Studio installa queste copie degli assembly di interoperabilità primari nei percorsi seguenti del computer di sviluppo:

  • %ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools per Office\PIA\Office12

    (o %ProgramFiles(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12 su sistemi operativi a 64 bit)

  • %Programmi%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office14

    (o %ProgramFiles(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools per Office\PIA\Office14 su sistemi operativi a 64 bit)

Assembly di interoperabilità primari della Global Assembly Cache

Per eseguire determinate attività di sviluppo, è necessario che gli assembly di interoperabilità primari di Office siano installati e registrati nella Global Assembly Cache del computer di sviluppo. Gli assembly di interoperabilità primari vengono in genere installati automaticamente all'installazione di Office nel computer di sviluppo. Per ulteriori informazioni, vedere Configurazione di un computer per sviluppare soluzioni Office.

Per eseguire soluzioni Office destinate a .NET Framework 3.5, è necessario che gli assembly di interoperabilità primari di Office siano installati e registrati nella Global Assembly Cache dei computer degli utenti finali. Tuttavia, gli assembly di interoperabilità primari di Office non sono richiesti nei computer degli utenti finali per eseguire soluzioni Office che hanno .NET Framework 4 come destinazione. Per ulteriori informazioni, vedere Progettazione e creazione di soluzioni Office.

Utilizzo di funzionalità di più applicazioni di Microsoft Office in un unico progetto

Ciascun modello di progetto di Office in Visual Studio è destinato all'utilizzo con una sola applicazione di Microsoft Office. Per utilizzare le funzionalità di più applicazioni Microsoft Office oppure le funzionalità di un'applicazione o di un componente che non dispone di un progetto in Visual Studio, è necessario aggiungere un riferimento agli assembly di interoperabilità primari (PIA) necessari.

Nella maggior parte dei casi vanno aggiunti riferimenti ai PIA installati da Visual Studio nella directory %Programmi%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\. Tali versioni degli assembly vengono visualizzate nella scheda .NET della finestra di dialogo Aggiungi riferimento. Per ulteriori informazioni, vedere Procedura: sviluppare applicazioni di Office mediante gli assembly di interoperabilità primari.

Se gli assembly di interoperabilità primari (PIA) sono stati installati e registrati nella Global Assembly Cache, le versioni degli assembly vengono visualizzate nella scheda COM della finestra di dialogo Aggiungi riferimento. Evitare di aggiungere riferimenti a tali versioni degli assembly poiché il loro utilizzo potrebbe dare luogo a problemi di sviluppo. Se, ad esempio, nella Global Assembly Cache sono state registrate versioni differenti degli assembly di interoperabilità primari (PIA), il progetto viene associato automaticamente alla versione dell'assembly registrata per ultima, anche se nella scheda COM della finestra di dialogo Aggiungi riferimento viene specificata una versione diversa dell'assembly.

Nota

Alcuni assembly vengono aggiunti automaticamente a un progetto quando si aggiunge un assembly che fa riferimento a essi. I riferimenti agli assembly Office.dll e Microsoft.Vbe.Interop.dll, ad esempio, vengono aggiunti automaticamente in caso di aggiunta di un riferimento agli assembly Word, Excel, Outlook, Microsoft Forms o Graph.

Assembly di interoperabilità primari per applicazioni Microsoft Office

Nella tabella riportata di seguito vengono elencati gli assembly di interoperabilità primari disponibili per Microsoft Office 2010 e Microsoft Office System 2007.

Applicazione o componente di Office

Nome dell'assembly di interoperabilità primario

Libreria oggetti di Microsoft Access 12.0

Libreria oggetti di Microsoft Access 14.0

Microsoft.Office.Interop.Access.dll

Libreria oggetti motore di gestione di database di Microsoft Office Access 2007

Libreria oggetti motore di gestione di database di Microsoft Office Access 14.0

Microsoft.Office.Interop.Access.Dao.dll

Libreria oggetti di Microsoft Excel 12.0

Libreria oggetti di Microsoft Excel 14.0

Microsoft.Office.Interop.Excel.dll

Libreria oggetti di Microsoft Graph 12.0 (utilizzata da PowerPoint, Access e Word per i grafici)

Libreria oggetti di Microsoft Graph 14.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 di Microsoft Office 12.0 (funzionalità condivisa di Office)

Libreria oggetti di Microsoft Office 14.0 (funzionalità condivisa di Office)

office.dll

Microsoft Office Outlook - Controllo visualizzazione (può essere utilizzato in applicazioni e pagine Web per accedere alla cartella Posta in arrivo)

Microsoft.Office.Interop.OutlookViewCtl.dll

Libreria oggetti di Microsoft Outlook 12.0

Libreria oggetti di Microsoft Outlook 14.0

Microsoft.Office.Interop.Outlook.dll

Libreria oggetti di Microsoft PowerPoint 12.0

Libreria oggetti di Microsoft PowerPoint 14.0

Microsoft.Office.Interop.PowerPoint.dll

Libreria oggetti di Microsoft Project 12.0

Libreria oggetti di Microsoft Project 14.0

Microsoft.Office.Interop.MSProject.dll

Libreria oggetti di Microsoft Publisher 12.0

Libreria oggetti di Microsoft Publisher 14.0

Microsoft.Office.Interop.Publisher.dll

Libreria riferimenti a oggetti Web di Microsoft SharePoint Designer 12.0

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 12.0

Libreria riferimenti a oggetti pagina di Microsoft SharePoint Designer 14.0

Microsoft.Office.Interop.SharePointDesignerPage.dll

Libreria dei tipi Microsoft Smart Tags 2.0

NotaNota
Gli smart tag sono deprecati in Excel 2010 e Word 2010.Per ulteriori informazioni, vedere Cenni preliminari sugli smart tag.

Microsoft.Office.Interop.SmartTag.dll

Libreria dei tipi Microsoft Visio 12.0

Libreria dei tipi Microsoft Visio 14.0

Microsoft.Office.Interop.Visio.dll

Libreria dei tipi Salva come pagina Web Microsoft Visio 12.0

Libreria dei tipi Salva come pagina Web Microsoft Visio 14.0

Microsoft.Office.Interop.Visio.SaveAsWeb.dll

Libreria dei tipi controlli disegno di Microsoft Visio 12.0

Libreria dei tipi controlli disegno di Microsoft Visio 14.0

Microsoft.Office.Interop.VisOcx.dll

Libreria oggetti di Microsoft Word 12.0

Libreria oggetti di Microsoft Word 14.0

Microsoft.Office.Interop.Word.dll

Microsoft Visual Basic for Applications Extensibility 5.3

Microsoft.Vbe.Interop.dll

Assembly di reindirizzamento delle associazioni

Quando si installano e registrano gli assembly di interoperabilità primari di Office nel Global Assembly Cache (tramite Office o installando il package ridistribuibile per gli assembly di interoperabilità primari), gli assembly di reindirizzamento delle associazioni sono anche installati solo nel Global Assembly Cache. Questi assembly garantiscono che in fase di esecuzione venga caricata la versione corretta degli assembly di interoperabilità primari. Quando ad esempio una soluzione che fa riferimento a un assembly di interoperabilità primario di Microsoft Office 2007 viene eseguita in un computer in cui è installata la versione Microsoft Office 2010 dello stesso assembly, l'assembly di reindirizzamento delle associazioni indica al runtime di .NET Framework di caricare la versione Microsoft Office 2010 dell'assembly di interoperabilità primario. Per ulteriori informazioni, vedere Reindirizzamento delle versioni di assembly.

Ogni associazione reindirizza l'assembly ha un nome nel formato Policy.11.0.PIAName.dllo Policy.12.0.PIAName.dll, ad esempio Policy.11.0.Microsoft.Office.Interop.Excel.dll e Policy.12.0.Microsoft.Office.Interop.Excel.dll.

Vedere anche

Attività

Procedura: sviluppare applicazioni di Office mediante gli assembly di interoperabilità primari

Concetti

Soluzioni InfoPath

Soluzioni PowerPoint

Soluzioni Project

Cenni preliminari sul modello a oggetti di Visio

Altre risorse

Cenni preliminari sul modello a oggetti di Excel

Cenni preliminari sul modello a oggetti di Outlook

Cenni preliminari sul modello a oggetti di Word

Riferimenti generali (sviluppo per Office in Visual Studio)