Cenni preliminari su Visual Studio Tools per Office Runtime
Aggiornamento: novembre 2007
Per eseguire le soluzioni create in Visual Studio Tools per Office, sui computer degli utenti finali deve essere installato il runtime di Visual Studio Tools per Office. Il runtime include gli assembly gestiti che forniscono il livello di comunicazione tra la soluzione e l'applicazione di Microsoft Office e i componenti non gestiti che l'applicazione utilizza per caricare la soluzione.
Per informazioni sull'installazione del runtime nei computer degli utenti finali, vedere Procedura: installare il runtime di Microsoft Visual Studio Tools per Office.
In questo argomento vengono fornite le seguenti informazioni:
Informazioni sulle diverse versioni di runtime
Informazioni sugli assembly di runtime
Informazioni sui componenti del caricatore di runtime
Informazioni sulle diverse versioni di runtime
Nelle soluzioni Visual Studio Tools per Office, per ciascuna versione di Microsoft Office viene utilizzata una versione del runtime differente. La versione del runtime è determinata dal modello di progetto utilizzato per creare la soluzione e non dalla versione di Office usata per eseguire la soluzione.
Nella tabella seguente sono mostrate le versioni del runtime e di Microsoft Office necessarie per eseguire le soluzioni nel computer dell'utente finale.
Versione del modello di progetto |
Versione del runtime di Visual Studio Tools per Office richiesta nel computer dell'utente finale |
Versioni di Microsoft Office che possono eseguire la soluzione nel computer dell'utente finale |
|---|---|---|
Progetti per Microsoft Office System 2007 |
Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime) |
Microsoft Office System 2007 |
Progetti per Microsoft Office 2003 |
Visual Studio 2005 Tools per Office Second Edition Runtime |
Microsoft Office System 2007 Microsoft Office 2003 |
Entrambe le versioni del runtime vengono installate automaticamente nel computer di sviluppo quando si installa Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0).
Per informazioni sulla creazione di soluzioni che possono eseguire entrambe le versioni di Microsoft Office, vedere Creazione di soluzioni per più versioni di Microsoft Office.
Esistono alcune differenze tra gli assembly inclusi in ogni versione del runtime. Per ulteriori informazioni, vedere Differenze degli assembly.
.gif "Nota") Nota: |
|---|
Visual Studio 2005 Tools per Office Second Edition Runtime è rilasciato inizialmente con Microsoft Visual Studio 2005 Tools per Microsoft Office System 2007 (VSTO 2005 SE). Questa versione del runtime è utilizzata anche dalle soluzioni per Microsoft Office 2003 create con Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0). |
Documentazione di riferimento per entrambi i runtime
Quando si fa clic su un collegamento o su una voce dell'indice nella Guida per ottenere informazioni di riferimento per un spazio dei nomi, un tipo o un membro, è possibile che vengano restituiti due risultati quasi identici. Nei due argomenti vengono trattati i membri uguali delle due versioni del runtime. Selezionare l'argomento identificato dall'indicatore di versione corretto:
2007 System. Fa riferimento a Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime).
2003 System. Fa riferimento a Visual Studio 2005 Tools per Office Second Edition Runtime.
Informazioni sugli assembly di runtime
Gli assembly inclusi nel runtime di Visual Studio Tools per Office forniscono le seguenti categorie di classi:
Classi utilizzate dalla soluzione per automatizzare ed estendere l'applicazione host.
Classi di infrastruttura che consentono alla soluzione di comunicare con l'applicazione host.
| Nota: |
|---|
Quando si crea un progetto, Visual Studio Tools per Office aggiunge automaticamente i riferimenti agli assembly utilizzati per il tipo di progetto. Alcuni assembly sono utilizzati solo nei progetti a livello di documento mentre altri sono utilizzati solo nei progetti a livello di applicazione. |
Assembly nel runtime di Visual Studio Tools per Office 3.0
Nella tabella riportata di seguito sono elencati gli assembly inclusi in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). Questa versione del runtime è utilizzata dalle soluzioni create per Microsoft Office System 2007.
Per la documentazione sugli spazi dei nomi e sulle classi di questi assembly, vedere Riferimento gestito System 2007.
Nome assembly |
Descrizione |
|---|---|
Microsoft.Office.Tools.Common.v9.0.dll |
Fornisce le seguenti classi:
|
Microsoft.Office.Tools.Excel.v9.0.dll |
Fornisce gli elementi e i controlli host per le personalizzazioni a livello di documento di Excel. Per ulteriori informazioni, vedere Cenni preliminari sugli elementi e sui controlli host. |
Microsoft.Office.Tools.Outlook.v9.0.dll |
Fornisce le classi utilizzabili per creare aree del modulo personalizzate nei componenti aggiuntivi Outlook. |
Microsoft.Office.Tools.Word.v9.0.dll |
Fornisce gli elementi e i controlli host per le personalizzazioni a livello di documento di Word. Per ulteriori informazioni, vedere Cenni preliminari sugli elementi e sui controlli host. |
Microsoft.Office.Tools.v9.0.dll |
Fornisce le seguenti classi:
|
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll |
Fornisce le seguenti classi:
|
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll |
Fornisce le seguenti classi:
|
Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll |
Fornisce le seguenti classi:
|
Microsoft.VisualStudio.Tools.Office.AppInfoDocument.v9.0.dll Microsoft.VisualStudio.Tools.Office.Contract.v9.0.dll |
Forniscono le classi facenti parte dell'infrastruttura di Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). Tali classi non possono essere utilizzate direttamente dal codice. |
Assembly nel runtime di Visual Studio 2005 Tools per Office Second Edition
Nella tabella riportata di seguito sono elencati gli assembly inclusi in Visual Studio 2005 Tools per Office Second Edition Runtime. Questa versione del runtime è utilizzata dalle soluzioni create per Microsoft Office 2003.
Per la documentazione sugli spazi dei nomi e sulle classi di questi assembly, vedere Riferimento gestito System 2003.
Nome assembly |
Descrizione |
|---|---|
Microsoft.Office.Tools.Common.dll |
Fornisce le seguenti classi:
|
Microsoft.Office.Tools.Excel.dll |
Fornisce gli elementi e i controlli host per le personalizzazioni a livello di documento di Excel. Per ulteriori informazioni, vedere Cenni preliminari sugli elementi e sui controlli host. |
Microsoft.Office.Tools.Word.dll |
Fornisce gli elementi e i controlli host per le personalizzazioni a livello di documento di Word. Per ulteriori informazioni, vedere Cenni preliminari sugli elementi e sui controlli host. |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
Fornisce le seguenti classi:
|
Differenze degli assembly
Molti assembly inclusi in Visual Studio 2005 Tools per Office Second Edition Runtime hanno nomi diversi in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). Inoltre, un assembly che fa parte di Visual Studio 2005 Tools per Office Second Edition Runtime è stato suddiviso in molti assembly nuovi in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime).
Nella tabella riportata di seguito sono elencate le differenze:
Nome dell'assembly in Visual Studio 2005 Tools per Office Second Edition Runtime |
Nome dell'assembly in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime) |
|---|---|
Microsoft.Office.Tools.Common.dll |
Microsoft.Office.Tools.Common.v9.0.dll |
Microsoft.Office.Tools.Excel.dll |
Microsoft.Office.Tools.Excel.v9.0.dll |
Microsoft.Office.Tools.Word.dll |
Microsoft.Office.Tools.Word.v9.0.dll |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll Anche alcune classi sono state spostate nei nuovi assembly riportati di seguito:
|
Informazioni sui componenti del caricatore di runtime
Il runtime di Visual Studio Tools per Office include molte DLL non gestite che le applicazioni di Microsoft Office utilizzano per caricare le soluzioni Visual Studio Tools per Office. Anche se non si lavora mai direttamente con queste DLL, conoscerne lo scopo può permettere di comprendere meglio l'architettura delle soluzioni Visual Studio Tools per Office.
Per informazioni sulla modalità di utilizzo di questi componenti durante il processo di caricamento, vedere Architettura delle personalizzazioni a livello di documento e Architettura dei componenti aggiuntivi a livello di applicazione.
Caricatore di runtime
Quando un utente apre una personalizzazione a livello di documento o avvia un componente aggiuntivo, l'applicazione di Microsoft Office effettua una chiamata nel caricatore di runtime. Questo componente è denominato VSTOEE.dll.
Il caricatore di runtime assicura che venga caricata la versione del runtime Visual Studio Tools per Office corretta per la versione di Microsoft Office che carica il componente aggiuntivo. Anche se è possibile installare più versioni del runtime di Visual Studio Tools per Office nello stesso computer, viene installata solo un'istanza di VSTOEE.dll alla volta, ossia quella inclusa nella versione più recente del runtime installato nel computer.
Caricatore di soluzione
Il caricatore di soluzione esegue la maggior parte del lavoro richiesto per caricare l'assembly della soluzione. Il nome file del caricatore di soluzione varia a seconda della versione del runtime di Visual Studio Tools per Office. Il caricatore della soluzione in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime) è denominato VSTOLoader.dll. In Visual Studio 2005 Tools per Office Second Edition Runtime è denominato AddinLoader.dll.
Il caricatore della soluzione esegue diverse operazioni:
Crea un nuovo dominio applicazione per ogni assembly della soluzione Visual Studio Tools per Office.
Esegue una serie di controlli di sicurezza per verificare che l'assembly del componente aggiuntivo disponga delle autorizzazioni per l'esecuzione.
Il caricatore di soluzione esegue anche diverse operazioni specifiche dei componenti aggiuntivi:
Implementa l'interfaccia IDTExtensibility2. IDTExtensibility2 è un'interfaccia COM che deve essere implementata da tutti i componenti aggiuntivi per le applicazioni di Microsoft Office. Questa interfaccia definisce i metodi chiamati dall'applicazione per comunicare con il componente aggiuntivo.
Implementa l'interfaccia IManagedAddin. A partire da Microsoft Office System 2007, le applicazioni di Microsoft Office utilizzano questa interfaccia per consentire il caricamento di componenti aggiuntivi di Visual Studio Tools per Office. Per ulteriori informazioni, vedere Interfaccia IManagedAddin.
Vedere anche
Attività
Procedura: installare il runtime di Microsoft Visual Studio Tools per Office
Procedura: creare progetti Visual Studio Tools per Office
Concetti
Architettura delle personalizzazioni a livello di documento
Architettura dei componenti aggiuntivi a livello di applicazione
Aggiornamento e migrazione di soluzioni Office