Assembly di interoperabilità primari di Office

Aggiornamento: novembre 2007

Per utilizzare le funzionalità di un'applicazione Microsoft Office da un progetto Visual Studio Tools per Office è necessario utilizzare l'assembly di interoperabilità primario dell'applicazione. Gli assembly di interoperabilità primari consentono l'interazione tra il codice gestito e il modello a oggetti COM di un'applicazione di Microsoft Office.

Quando si crea un nuovo progetto Visual Studio Tools per 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 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:

• 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

• Assembly di interoperabilità primari di Microsoft Office 2003

• Assembly di interoperabilità primari di Microsoft Office System 2007

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

In Visual Studio Tools per Office vengono utilizzati insiemi diversi di assembly di interoperabilità primari nel 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. Gli assembly vengono installati automaticamente da Visual Studio Tools per Office.

• La Global Assembly Cache.

  Tali copie degli assembly vengono utilizzate per l'esecuzione o il debug di progetti. Poiché gli assembly non vengono installati e registrati da Visual Studio Tools per Office, l'operazione deve essere eseguita manualmente.

Assembly di interoperabilità primari nella directory Programmi

Durante l'installazione di Visual Studio Tools per Office, gli assembly di interoperabilità primari vengono installati automaticamente in un percorso nel file system, fuori dalla Global Assembly Cache. A ogni nuovo progetto creato in Visual Studio Tools per Office vengono aggiunti automaticamente riferimenti alle copie degli assembly di interoperabilità primari. Nello sviluppo e compilazione del progetto, Visual Studio Tools per Office utilizza tali copie degli assembly di interoperabilità primari, anziché gli assembly della Global Assembly Cache, per la risoluzione dei riferimenti al tipo.

Le copie degli assembly di interoperabilità primari consentono a Visual Studio Tools per Office di aggirare alcuni problemi di sviluppo che possono verificarsi quando nella Global Assembly Cache sono registrate sia la versione 2003 sia la versione 2007 degli assembly di interoperabilità primari di Office.

In Visual Studio Tools per Office, le copie degli assembly di interoperabilità primari vengono installate nei percorsi seguenti nel computer di sviluppo:

• %ProgramFiles%\Microsoft Visual Studio 9.0\Visual Studio Tools per Office\PIA\Office11

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

Assembly di interoperabilità primari della Global Assembly Cache

Per eseguire la maggior parte delle attività di sviluppo è necessario installare e registrare gli assembly di interoperabilità primari nella Global Assembly Cache. A tale scopo, eseguire un'installazione completa di Microsoft Office o installare il package ridistribuibile per gli assembly di interoperabilità primari. Per ulteriori informazioni, vedere Procedura: installare assembly di interoperabilità primari di Office.

Per eseguire le attività di sviluppo indicate di seguito è necessario che gli assembly di interoperabilità primari siano installati e registrati nella Global Assembly Cache:

• Creazione di progetti di personalizzazione a livello di documento.

• Esecuzione o debug di qualsiasi progetto Visual Studio Tools per Office.

Per eseguire le soluzioni Visual Studio Tools per Office nel computer dell'utente finale è necessario che gli assembly di interoperabilità primari siano installati e registrati nella Global Assembly Cache.

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

Ciascun modello di progetto di Visual Studio Tools per Office è destinato all'utilizzo con una sola applicazione di Microsoft Office. Per utilizzare le funzionalità di più applicazioni di Microsoft Office oppure le funzionalità di un'applicazione o di un componente cui non sia associato un progetto in Visual Studio Tools per Office, aggiungere un riferimento agli assembly di interoperabilità primari necessari. 

Nella maggior parte dei casi vanno aggiunti riferimenti agli assembly di interoperabilità primari installati da Visual Studio Tools per Office nella directory %ProgramFiles%. 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 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 entrambe le versioni 2003 e 2007 degli assembly di interoperabilità primari, 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 di Microsoft Office 2003

Nella tabella riportata di seguito vengono elencati gli assembly di interoperabilità primari disponibili per Microsoft Office 2003.

Applicazione o componente di Office	Nome dell'assembly di interoperabilità primario
Libreria oggetti di Microsoft Access 11.0	Microsoft.Office.Interop.Access.dll
Libreria oggetti di Microsoft Excel 11.0	Microsoft.Office.Interop.Excel.dll
Libreria riferimenti a oggetti Web di Microsoft FrontPage 6.0	Microsoft.Office.Interop.Frontpage.dll
Libreria riferimenti a oggetti pagina di Microsoft FrontPage 6.0	Microsoft.Office.Interop.Frontpageeditor.dll
Libreria oggetti di Microsoft Graph 11.0 (utilizzata da PowerPoint, Access e Word per i grafici)	Microsoft.Office.Interop.Graph.dll
Libreria oggetti di Microsoft Outlook 11.0	Microsoft.Office.Interop.Outlook.dll
Microsoft Outlook - Controllo visualizzazione (può essere utilizzato in applicazioni e pagine Web per accedere alla cartella Posta in arrivo)	Microsoft.Office.Interop.OutlookViewCtl.dll
Microsoft Office Web Components 11,0 (foglio di lavoro, grafico e tabella pivot per le pagine Web)	Microsoft.Office.Interop.owc11.dll
Libreria oggetti di Microsoft PowerPoint 11.0	Microsoft.Office.Interop.PowerPoint.dll
Libreria oggetti di Microsoft Project 11.0	Microsoft.Office.Interop.MSProject.dll
Libreria oggetti di Microsoft Publisher 11.0	Microsoft.Office.Interop.Publisher.dll
Libreria dei tipi Microsoft Smart Tags 2.0	Microsoft.Office.Interop.SmartTag.dll
Libreria oggetti di Microsoft Word 11.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Extensibility 5.3	Microsoft.Vbe.Interop.dll
Libreria oggetti di Microsoft Forms 2.0 (controlli programmabili da utilizzare nelle applicazioni)	Microsoft.Vbe.Interop.Forms.dll
Libreria oggetti di Microsoft Office 11.0 (funzionalità condivisa di Office)	office.dll

Assembly di interoperabilità primari di Microsoft Office System 2007

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

Applicazione o componente di Office	Nome dell'assembly di interoperabilità primario
Libreria oggetti di Microsoft Access 12.0	Microsoft.Office.Interop.Access.dll
Libreria oggetti modulo di gestione di database di Microsoft Office Access 2007	Microsoft.Office.Interop.Access.Dao.dll
Libreria oggetti di Microsoft Excel 12.0	Microsoft.Office.Interop.Excel.dll
Libreria oggetti di Microsoft Graph 12.0 (utilizzata da PowerPoint, Access e Word per i grafici)	Microsoft.Office.Interop.Graph.dll
Libreria dei tipi Microsoft InfoPath 2.0	Microsoft.Office.Interop.InfoPath.dll
Assembly di interoperabilità XML di Microsoft InfoPath	Microsoft.Office.Interop.InfoPath.Xml.dll
Libreria oggetti di Microsoft Outlook 12.0	Microsoft.Office.Interop.Outlook.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 PowerPoint 12.0	Microsoft.Office.Interop.PowerPoint.dll
Libreria oggetti di Microsoft Project 12.0	Microsoft.Office.Interop.MSProject.dll
Libreria oggetti di Microsoft Publisher 12.0	Microsoft.Office.Interop.Publisher.dll
Libreria riferimenti a oggetti Web di Microsoft SharePointDesigner 12.0	Microsoft.Office.Interop.SharePointDesigner.dll
Libreria riferimenti a oggetti pagina di Microsoft SharePointDesigner 12.0	Microsoft.Office.Interop.SharePointDesignerPage.dll
Libreria dei tipi Microsoft Smart Tags 2.0	Microsoft.Office.Interop.SmartTag.dll
Libreria dei tipi Microsoft Visio 12.0	Microsoft.Office.Interop.Visio.dll
Libreria dei tipi Salva come pagina Web Microsoft Visio 12.0	Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Libreria dei tipi controlli disegno di Microsoft Visio 12.0	Microsoft.Office.Interop.VisOcx.dll
Libreria oggetti di Microsoft Word 12.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Extensibility 5.3	Microsoft.Vbe.Interop.dll
Libreria oggetti di Microsoft Office 12.0 (funzionalità condivisa di Office)	office.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Access	Policy.11.0.Microsoft.Office.Interop.Access.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Excel	Policy.11.0.Microsoft.Office.Interop.Excel.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Graph	Policy.11.0.Microsoft.Office.Interop.Graph.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft InfoPath	Policy.11.0.Microsoft.Office.Interop.InfoPath.dll
Assembly di reindirizzamento delle associazioni per l'assembly di interoperabilità XML di Microsoft InfoPath	Policy.11.0.Microsoft.Office.Interop.InfoPath.Xml.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Outlook	Policy.11.0.Microsoft.Office.Interop.Outlook.dll
Assembly di reindirizzamento delle associazioni per Microsoft Outlook - Controllo visualizzazione	Policy.11.0.Microsoft.Office.Interop.OutlookViewCtl.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft PowerPoint	Policy.11.0.Microsoft.Office.Interop.PowerPoint.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Project	Policy.11.0.Microsoft.Office.Interop.MSProject.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Publisher	Policy.11.0.Microsoft.Office.Interop.Publisher.dll
Assembly di reindirizzamento delle associazioni per la Libreria dei tipi Microsoft Smart Tags	Policy.11.0.Microsoft.Office.Interop.SmartTag.dll
Libreria dei tipi Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.Visio.dll
Assembly di reindirizzamento delle associazioni per la Libreria dei tipi Salva come pagina Web	Policy.11.0.Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Assembly di reindirizzamento delle associazioni per la Libreria dei tipi controlli disegno di Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.VisOcx.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Word	Policy.11.0.Microsoft.Office.Interop.Word.dll
Assembly di reindirizzamento delle associazioni per Microsoft Visual Basic for Applications Extensibility 5.3	Policy.11.0.Microsoft.Vbe.Interop.dll
Assembly di reindirizzamento delle associazioni per la Libreria oggetti di Microsoft Office	Policy.11.0.office.dll

Nota:

Gli assembly di reindirizzamento delle associazioni garantiscono che in fase di esecuzione venga caricata la versione Microsoft Office 2007 degli assembly di interoperabilità primari. Quando una soluzione di Visual Studio Tools per Office che fa riferimento a un assembly di interoperabilità primario di Microsoft Office 2003 viene eseguita in un computer in cui è installata la versione Microsoft Office 2007 dello stesso assembly, l'assembly di reindirizzamento delle associazioni indica al runtime di .NET Framework di caricare la versione Microsoft Office 2007 dell'assembly di interoperabilità primario. Per ulteriori informazioni, vedere Reindirizzamento delle versioni di assembly.

Vedere anche

Attività

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

Altre risorse

Riferimenti generali (Visual Studio Tools per Office)