Cenni preliminari su Visual Studio Tools per Office Runtime

Articolo
08/11/2011

Per eseguire soluzioni create tramite gli strumenti di sviluppo di Microsoft Office in Visual Studio 2010, i computer degli utenti finali devono disporre di Visual Studio 2010 Tools per Office Runtime. 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 due estensioni di Office per .NET Framework:

Le estensioni di Office per .NET Framework 3.5 vengono utilizzate da soluzioni destinate a .NET Framework 3.5.
Le estensioni di Office per .NET Framework 4 vengono utilizzate da soluzioni destinate a .NET Framework 4.

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 in versioni precedenti del Runtime di Visual Studio Tools per Office. Viceversa, la maggior parte dei tipi utilizzati nelle estensioni di Office per .NET Framework 4 sono interfacce. Ad esempio, quando si fa riferimento a .NET Framework 4, i tipi Microsoft.Office.Tools.Excel.Worksheet e Microsoft.Office.Tools.Word.Document sono interfacce e non 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.

Interfacce nelle estensioni di Office per .NET Framework 4

La maggior parte delle interfacce nelle estensioni di Office per .NET Framework 4 non deve 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 Visual Studio 2010 Tools per Office Runtime e 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 dei tipi e tipi incorporati in progetti destinati a .NET Framework 4

Il modello a oggetti basato sull'interfaccia delle estensioni di Office per .NET Framework 4 consente di utilizzare la funzionalità di equivalenza dei tipi in Visual C# 2010 e Visual Basic 2010 per incorporare nella soluzione informazioni sul tipo da Runtime di Visual Studio Tools per Office. Questa funzionalità consente a soluzioni Office e a Runtime di Visual Studio Tools per Office di controllare le versioni in modo indipendente uno 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 dei tipi non è abilitata quando si crea un progetto di Office destinato a .NET Framework 4. 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 include 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

Esistono versioni distinte, a 64 bit e a 32 bit, del Visual Studio 2010 Tools per Office Runtime. Tali versioni del runtime vengono utilizzate per l'esecuzione di soluzioni in edizioni a 64 bit e a 32 bit di Microsoft Office 2010. Nella tabella seguente viene illustrata la versione del runtime richiesta per ogni combinazione di Microsoft Windows e Microsoft Office 2010.

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

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

La versione a 64 bit di Microsoft Office 2010 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 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