Panoramica del runtime di Strumenti di Visual Studio per Office

  • Articolo

Per eseguire soluzioni create con gli strumenti di sviluppo di Microsoft Office in Visual Studio, è necessario installare visual Studio 2010 Tools per Office runtime nei computer degli utenti finali. Per altre informazioni, vedere Procedura: Installare il Strumenti di Visual Studio per il runtime di Office ridistribuibile. Il runtime di Visual Studio 2010 Tools per Office è costituito da due componenti principali:

  • Le estensioni di Office per .NET Framework. Questi componenti sono assembly gestiti che forniscono il livello di comunicazione tra la soluzione e l'applicazione di Microsoft Office. Per altre informazioni, vedere Informazioni sulle estensioni di Office per .NET Framework.

  • Il caricatore di soluzioni Office. Questo componente è un set di DLL non gestite che le applicazioni di Office usano per caricare il runtime e le soluzioni. Per altre informazioni, vedere Informazioni sul caricatore della soluzione Office.

    È possibile installare il runtime in numerose modalità diverse. A seconda della configurazione del computer, al momento dell'installazione del runtime vengono installati componenti di runtime diversi. Per altre informazioni, vedere Strumenti di Visual Studio per scenari di installazione del runtime di Office.

Informazioni sulle estensioni di Office per .NET Framework

Il runtime di Visual Studio 2010 Tools per Office include estensioni di Office per .NET Framework 3.5, .NET Framework 4 e versioni successive. Nelle soluzioni destinate a ciascuna versione di .NET Framework vengono usate le estensioni appropriate per la versione interessata.

Queste estensioni sono costituite da assembly usati dalle soluzioni per automatizzare ed estendere le applicazioni di Office. Quando si crea un progetto di Office, in Visual Studio vengono automaticamente aggiunti riferimenti agli assembly usati per il tipo di progetto e .NET Framework di destinazione del progetto. Per altre informazioni sugli assembly nelle estensioni di Office, vedere Assembly nel runtime di Strumenti di Visual Studio per Office.

Differenze di progettazione nelle estensioni di Office

La maggior parte dei tipi usati nelle estensioni di Office per .NET Framework 3.5 sono classi. Si tratta delle stesse classi incluse nelle versioni precedenti della Strumenti di Visual Studio per il runtime di Office. Al contrario, la maggior parte dei tipi usati nelle estensioni di Office per .NET Framework 4 o versioni successive sono interfacce. Ad esempio, quando si usa .NET Framework 4 o versione successiva, i Worksheet tipi e Document sono interfacce anziché classi.

Nella maggior parte dei casi, il codice scritto nelle soluzioni Office è lo stesso se la soluzione è destinata a .NET Framework 3.5 o a .NET Framework 4. Tuttavia, alcune funzionalità richiedono codice diverso quando si ha come destinazione versioni diverse di .NET Framework. Per altre informazioni, vedere Eseguire la migrazione di soluzioni Office a .NET Framework 4 o versione successiva.

Interfacce nelle estensioni di Office per .NET Framework 4 o versioni successive

La maggior parte delle interfacce nelle estensioni di Office per .NET Framework 4 o versioni successive non è progettata per essere implementata dal codice utente. Le uniche interfacce che è possibile implementare direttamente hanno nomi che iniziano con la lettera I, ad esempio ISmartTagExtension.

Tutte le interfacce che non iniziano con la lettera I vengono implementate internamente dal runtime di Visual Studio 2010 Tools per Office e queste interfacce potrebbero cambiare nelle versioni future. Per creare oggetti che implementano tali interfacce, usare i metodi forniti dall'oggetto Globals.Factory nel progetto. Ad esempio, per ottenere un oggetto che implementa l'interfaccia SmartTag, usare il metodo Globals.Factory.CreateSmartTag. Per altre informazioni su Globals.Factory, vedere Accesso globale agli oggetti nei progetti di Office.

Abilitare l'equivalenza dei tipi e i tipi incorporati nei progetti destinati a .NET Framework 4 o versione successiva

Poiché il modello a oggetti delle estensioni di Office per .NET Framework 4 o versioni successive si basa sulle interfacce, è possibile usare la funzionalità di equivalenza dei tipi sia in Visual C# che in Visual Basic in Visual Studio per incorporare informazioni sul tipo dal runtime di Strumenti di Visual Studio per Office nella soluzione. Questa funzionalità consente alle soluzioni Office e alle Strumenti di Visual Studio per il runtime di Office di eseguire la versione indipendentemente l'una dall'altra. Se ad esempio la soluzione usa l'interfaccia Document come tipo incorporato e la versione successiva del runtime aggiunge membri all'interfaccia Document , la soluzione funzionerà comunque con la versione successiva del runtime. Se la soluzione non usa l'interfaccia Document come tipo incorporato, non funzionerà più con la versione successiva del runtime.

Per impostazione predefinita, la funzionalità di equivalenza del tipo non è abilitata quando si crea un progetto di Office destinato a .NET Framework 4 o versione successiva. Se si desidera abilitare tale funzionalità, impostare la proprietà Incorpora tipi di interoperabilità di uno qualsiasi dei seguenti riferimenti all'assembly nel progetto su True:

  • Microsoft.Office.Tools.dll

  • Microsoft.Office.Tools.Common.dll

  • Microsoft.Office.Tools.Excel.dll

  • Microsoft.Office.Tools.Outlook.dll

  • Microsoft.Office.Tools.Word.dll

    Dopo avere effettuato tale modifica, le informazioni sul tipo per tutti i tipi di runtime usati dal progetto vengono incorporate nell'assembly della soluzione quando il progetto viene compilato. In fase di esecuzione, la soluzione usa tali informazioni sul tipo incorporato, anziché le informazioni sui tipi negli assembly a cui si fa riferimento.

Informazioni sul caricatore della soluzione Office

Il runtime di Visual Studio Tools per Office include molte DLL non gestite che nelle applicazioni di Office servono a caricare il runtime e le soluzioni Office. Anche se non si lavora mai direttamente con queste DLL, conoscerne lo scopo può permettere di comprendere meglio l'architettura delle soluzioni Office.

Per informazioni sull'uso di questi componenti durante il processo di caricamento, vedere Architettura delle personalizzazioni a livello di documento e Architettura dei componenti aggiuntivi VSTO.

vstoee.dll

Quando un utente apre una personalizzazione a livello di documento o avvia un componente aggiuntivo VSTO, la app Office lication chiama in VSTO edizione Enterprise.dll per eseguire le attività necessarie per caricare il Strumenti di Visual Studio per il runtime di Office.

VSTO edizione Enterprise.dll assicura che la versione corretta del runtime di Strumenti di Visual Studio per Office venga caricata per la soluzione e la versione installata di Office. Anche se è possibile installare più versioni del runtime di Strumenti di Visual Studio per Office nello stesso computer, viene installata una sola istanza di VSTO edizione Enterprise.dll alla volta. Si tratta del FILE VSTO edizione Enterprise.dll incluso con la versione più recente del runtime installato nel computer. Per altre informazioni sulle diverse versioni del runtime di Strumenti di Visual Studio per Office che possono essere usate per altre soluzioni, vedere Eseguire soluzioni in versioni diverse di Microsoft Office.

VSTOLoader.dll

Dopo che VSTO edizione Enterprise.dll carica la versione appropriata del Strumenti di Visual Studio per il runtime di Office , VSTOLoader.dll esegue la maggior parte del lavoro necessario per caricare l'assembly della soluzione. VSTOLoader.dll esegue diverse operazioni:

  • Creare un dominio dell'applicazione per ogni assembly della soluzione.

  • Eseguire un set di controlli di sicurezza per verificare che l'assembly della soluzione disponga delle autorizzazioni per l'esecuzione.

  • Caricare la versione delle estensioni di Office per .NET Framework richiesta dalla soluzione.

    VSTOLoader.dll esegue anche diverse operazioni specifiche dei componenti aggiuntivi VSTO:

  • Implementa l'interfaccia IDTExtensibility2 . IDTExtensibility2 è un'interfaccia COM che deve essere implementata da tutti i componenti aggiuntivi VSTO per le applicazioni di Microsoft Office. Questa interfaccia definisce i metodi chiamati dall'applicazione per comunicare con il componente aggiuntivo VSTO.

  • Implementa l'interfaccia IManagedAddin. Questa interfaccia viene usata dalle app Office licazioni per caricare i componenti aggiuntivi VSTO. Per altre informazioni, vedere Interfaccia IManagedAddin.

Informazioni sulle versioni a 32 bit e a 64 bit del runtime

Sono disponibili versioni separate a 64 bit e a 32 bit del runtime di Visual Studio 2010 Tools per Office. Tali versioni del runtime vengono usate per eseguire soluzioni in edizioni di Office a 64 bit e a 32 bit. Nella tabella seguente viene illustrata la versione del runtime richiesta per ogni combinazione di Windows e Office.

Edizione di Windows Edizione di Microsoft Office Versione richiesta del runtime di Visual Studio Tools per Office
32 bit 32 bit 32 bit
64 bit 32 bit 64 bit
64 bit 64 bit 64 bit

Quando si installa Office, viene installata la versione richiesta del runtime di Strumenti di Visual Studio per Office insieme a Office. Ad esempio, quando si installa l'edizione a 64 bit di Office in una versione a 64 bit di Windows, viene installata anche la versione a 64 bit del Strumenti di Visual Studio per il runtime di Office. Per altre informazioni sull'installazione del runtime di Strumenti di Visual Studio per Office con Office, vedere Strumenti di Visual Studio per gli scenari di installazione del runtime di Office.

La versione a 64 bit di Office può eseguire anche soluzioni Office create mediante modelli di progetto per Microsoft Office System 2007 in Visual Studio 2008. Non è tuttavia in grado di eseguire soluzioni Office create mediante modelli di progetto per Microsoft Office 2003 in Visual Studio 2008 né soluzioni Office create usando Visual Studio 2005. Per altre informazioni, vedere Eseguire soluzioni in versioni diverse di Microsoft Office.

Ripristinare il runtime di Visual Studio 2010 Tools per Office

Se è necessario ripristinare il runtime, aprire Programmi e funzionalità o Installazione applicazioni nel Pannello di controllo, selezionare Microsoft Visual Studio 2010 Tools per Office Runtime nell'elenco di programmi, quindi fare clic su Disinstalla. Il programma di installazione che viene eseguito consente di ripristinare il runtime. Se si fa clic su Cambia, non viene fornita un'opzione per ripristinare il runtime.

Contenuto correlato