Cenni preliminari su Visual Studio Tools per Office Runtime

Articolo
02/19/2013

Per eseguire soluzioni create tramite gli strumenti di sviluppo di Microsoft Office in Visual Studio 2012, Visual Studio 2010 tools per Office runtime deve essere installato nei computer degli utenti finali.Visual Studio 2010 tools per Office runtime è 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 ulteriori informazioni, vedere Estensioni di Office per .NET Framework.
Il caricatore di soluzioni Office.Questo componente è un set di DLL non gestite che le applicazioni di Office utilizzano per caricare il runtime e le soluzioni.Per ulteriori informazioni, vedere Informazioni sul caricatore di soluzioni 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 ulteriori informazioni, vedere Scenari di installazione del runtime di Visual Studio Tools per Office.

Estensioni di Office per .NET Framework

Visual Studio 2010 tools per Office runtime include estensioni di Office per .NET Framework 3.5, .NET Framework 4e .NET Framework 4.5.Soluzioni destinate a ogni versione di.NET Framework utilizzano le estensioni appropriate per tale versione.

Queste estensioni sono costituite da assembly utilizzati 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 utilizzati per il tipo di progetto e .NET Framework di destinazione del progetto.Per ulteriori informazioni sugli assembly nelle estensioni di Office, vedere Assembly nel runtime di Visual Studio Tools per Office.

Differenze di progettazione nelle estensioni di Office

La maggior parte dei tipi utilizzati nelle estensioni di Office per .NET Framework 3.5 sono classi.Si tratta delle stesse classi incluse nelle versioni precedenti di Runtime di Visual Studio Tools per Office. Al contrario, la maggior parte dei tipi utilizzati nelle estensioni di Office per .NET Framework 4 e .NET Framework 4.5 sono interfacce.Ad esempio, se la destinazione è .NET Framework 4 o .NET Framework 4.5, i tipi di Microsoft.Office.Tools.Word.Document e di Microsoft.Office.Tools.Excel.Worksheet sono interfacce anziché classi.

Nella maggior parte dei casi, il codice che si scrive nelle soluzioni Office è lo stesso sia che la soluzione venga 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 ulteriori informazioni, vedere Migrazione di soluzioni Office a .NET Framework 4 o a .NET Framework 4.5.

Interfacce nelle estensioni di Office per .NET Framework 4 e .NET Framework 4.5

La maggior parte delle interfacce nelle estensioni di Office per .NET Framework 4 e di .NET Framework 4.5 non devono essere implementati 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 dagli strumenti di Visual Studio 2010 per Office runtime e da queste interfacce potrebbero cambiare in versioni successive.Per creare oggetti che implementano tali interfacce, utilizzare i metodi forniti dall'oggetto Globals.Factory nel progetto.Ad esempio, per ottenere un oggetto che implementa l'interfaccia SmartTag, utilizzare il metodo Globals.Factory.CreateSmartTag.Per ulteriori informazioni su Globals.Factory, vedere Accesso globale a oggetti nei progetti di Office.

Abilitazione di equivalenza del tipo e tipi incorporati nei progetti destinati a .NET Framework 4 e .NET Framework 4.5

Poiché il modello a oggetti delle estensioni di Office per .NET Framework 4 e .NET Framework 4.5 sono basati sulle interfacce, è possibile utilizzare la funzionalità di equivalenza del tipo in entrambi in Visual c e Visual Basic in Visual Studio 2012 per incorporare informazioni sul tipo da Runtime di Visual Studio Tools per Office nella soluzione. Questa funzionalità consente alle soluzioni Office e a Runtime di Visual Studio Tools per Office alla versione indipendentemente dall'altro.Se ad esempio la soluzione utilizza l'interfaccia Microsoft.Office.Tools.Word.Document come tipo incorporato e la versione successiva del runtime aggiunge membri all'interfaccia Microsoft.Office.Tools.Word.Document, la soluzione funzionerà comunque con la versione successiva del runtime.Se la soluzione non utilizza l'interfaccia Microsoft.Office.Tools.Word.Document come tipo incorporato, non funzionerà più con la versione successiva del runtime.

Per impostazione predefinita, la funzionalità di equivalenza del tipo non viene attivata quando si crea un progetto Office destinato a .NET Framework 4 o .NET Framework 4.5.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 utilizzati dal progetto vengono incorporate nell'assembly della soluzione quando il progetto viene compilato.In fase di esecuzione, la soluzione utilizza tali informazioni sul tipo incorporato, anziché le informazioni sui tipi negli assembly a cui si fa riferimento.

Caricatore di soluzioni Office

Il runtime di Visual Studio Tools per Office includono molte DLL non gestite che le applicazioni di Office utilizzano per 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 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.

VSTOEE.dll

Quando un utente apre una personalizzazione a livello di documento o avvia un componente aggiuntivo, l'applicazione di Office effettua la chiamata a VSTOEE.dll per eseguire le attività richieste per caricare Runtime di Visual Studio Tools per Office.

VSTOEE.dll verifica che venga caricata la versione corretta di Runtime di Visual Studio Tools per Office per la soluzione e la versione installata di Office.Anche se è possibile installare più versioni di 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.Per ulteriori informazioni sulle diverse versioni di Runtime di Visual Studio Tools per Office che possono essere utilizzate per altre soluzioni, vedere Esecuzione di soluzioni in versioni diverse di Microsoft Office.

VSTOLoader.dll

Dopo il caricamento da parte di VSTOEE.dll della versione appropriata di Runtime di Visual Studio Tools per Office, VSTOLoader.dll esegue la maggior parte delle operazioni necessarie per caricare l'assembly della soluzione.VSTOLoader.dll consente di effettuare quanto riportato di seguito:

Creare un dominio 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 consente anche di eseguire alcune 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.Questa interfaccia viene utilizzata dalle applicazioni di Office per consentire il caricamento di componenti aggiuntivi a livello di applicazione.Per ulteriori informazioni, vedere Interfaccia IManagedAddin.

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

Vi sono 64 bit e versioni distinte a 32 bit di Visual Studio 2010 tools per Office runtime.Queste versioni del runtime vengono utilizzate per eseguire soluzioni in edizioni a 64 bit e a 32 bit di Office 2013 e di Office 2010.Illustrato nella tabella che la versione del runtime richiesta per ogni combinazione di Windows e Office 2013 o Office 2010.

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

Quando si installa Office 2013 o Office 2010, la versione richiesta di Runtime di Visual Studio Tools per Office viene installato con Office.Ad esempio, quando si installa l'edizione a 64 bit di Office 2013 o di Office 2010 su una versione a 64 bit di Windows, la versione a 64 bit di Runtime di Visual Studio Tools per Office viene installata.Per ulteriori informazioni sull'installazione Runtime di Visual Studio Tools per Office con Office 2013 o Office 2010, vedere Scenari di installazione del runtime di Visual Studio Tools per Office.

La versione a 64 bit di Office 2013 o di Office 2010 può inoltre eseguire 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 utilizzando Visual Studio 2005.Per ulteriori informazioni, vedere Esecuzione di soluzioni in versioni diverse di Microsoft Office.

Ripristino di Visual Studio 2010 Tools per Office Runtime

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 e 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.

Vedere anche

Condividi tramite