Aggiornamento e migrazione di soluzioni Office

Se si dispone di un progetto di Microsoft Office creato in una versione precedente di Visual Studio, è necessario aggiornare il progetto per utilizzarlo in Visual Studio 2010. Per aggiornare un progetto di Microsoft Office, aprirlo in una versione di Visual Studio 2010 che include gli strumenti di sviluppo di Microsoft Office. Per ulteriori informazioni sul processo di aggiornamento, vedere Procedura: aggiornare soluzioni Office. Per ulteriori informazioni sulle versioni di Visual Studio 2010 che includono gli strumenti di sviluppo di Microsoft Office, vedere Configurazione di un computer per sviluppare soluzioni Office.

Quando si aggiorna un progetto di Microsoft Office, Visual Studio apporta diverse modifiche al progetto. Alcune delle modifiche dipendono dalla versione di .NET Framework e Microsoft Office installata nel computer di sviluppo e dal tipo di progetto, se si tratta di un progetto a livello di documento o di un progetto a livello di applicazione.

È anche possibile modificare in qualsiasi momento il framework di destinazione dei progetti di Office da .NET Framework 3.5 a .NET Framework 4 o viceversa. Per ulteriori informazioni, vedere Procedura: scelta di una versione o profilo di .NET Framework specifico. Se si modifica il framework di destinazione, potrebbero essere necessari ulteriori passaggi per eseguire la soluzione con la nuova destinazione sui computer di sviluppo e dell'utente finale; in questo modo il progetto non verrà più compilato se utilizza determinate funzionalità. Per ulteriori informazioni, vedere Migrazione di soluzioni Office a .NET Framework 4.

Versioni supportate per l'aggiornamento dei progetti

È possibile aggiornare i progetti di Office creati utilizzando una qualsiasi delle seguenti versioni di Visual Studio Tools per Office:

• Microsoft Visual Studio 2005 Tools per Microsoft Office System.

• Microsoft Visual Studio 2005 Tools per Microsoft Office System 2007 (VSTO 2005 SE).

• Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0). Questa versione di Visual Studio Tools per Office è inclusa con Visual Studio 2008.

Visual Studio 2010 non supporta l'aggiornamento di progetti di Microsoft Office creati tramite Visual Studio Tools per Office, versione 2003. Per continuare a sviluppare uno di questi progetti in Visual Studio 2010, creare un nuovo progetto di Office e portare manualmente il codice nel nuovo progetto.

Modifiche apportate ai progetti aggiornati

Quando viene aggiornato un progetto di Microsoft Office, Visual Studio apporta le seguenti modifiche al progetto:

• Aggiorna la versione del runtime di Visual Studio Tools per Office di destinazione del progetto a Visual Studio 2010 Tools per Office Runtime.

  Per ulteriori informazioni sul runtime di Visual Studio Tools per Office, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

• Aggiorna la versione di .NET Framework di destinazione del progetto, se necessario.

• Aggiorna i riferimenti all'assembly nel progetto.

• Modifica il progetto in modo che abbia come destinazione la versione di Microsoft Office installata nel computer di sviluppo (Microsoft Office 2010 o Microsoft Office System 2007) se il progetto originale aveva come destinazione una versione precedente di Microsoft Office. Se non è installata alcuna versione di Microsoft Office, il progetto aggiornato ha come destinazione Microsoft Office System 2007.

.NET Framework di destinazione

Quando si aggiorna un progetto di Visual Studio Tools per Office in Visual Studio 2010, Visual Studio modifica .NET Framework di destinazione nei seguenti casi:

• Il progetto originale è destinato a .NET Framework 2.0. In questo caso, Visual Studio modifica il progetto in modo che abbia .NET Framework 3.5 come destinazione, qualora nel computer di sviluppo sia installato sia .NET Framework 3.5 che .NET Framework 4. Se è installato solo .NET Framework 4, Visual Studio modifica il progetto in modo abbia .NET Framework 4 come destinazione.

• Il progetto ha come destinazione .NET Framework 3.5, ma sul computer di sviluppo è installato solo .NET Framework 4. In questo caso, Visual Studio modifica il progetto in modo che abbia .NET Framework 4 come destinazione.

Se il progetto ha già come destinazione .NET Framework 3.5, Visual Studio non aggiornerà il framework di destinazione nel progetto aggiornato se .NET Framework 3.5 è installato anche sul computer di sviluppo.

Nella tabella seguente vengono riepilogate le modifiche del framework di destinazione per i progetti aggiornati.

Framework di destinazione del progetto originale	Versioni del Framework sul computer di sviluppo	Framework di destinazione del progetto aggiornato
.NET Framework 2.0 .NET Framework 3.5	.NET Framework 3.5 e .NET Framework 4	.NET Framework 3.5 Nota Se il progetto originale ha .NET Framework 3.5 Client Profile come destinazione, il progetto aggiornato ha .NET Framework 3.5 come destinazione.
.NET Framework 2.0 .NET Framework 3.5	.NET Framework 4	.NET Framework 4 Nota Se il progetto originale ha .NET Framework 3.5 Client Profile come destinazione, il progetto aggiornato ha .NET Framework 4 Client Profile come destinazione.

Quando si imposta come destinazione .NET Framework 4 in un progetto di Office, è possibile utilizzare determinate funzionalità non disponibili quando la destinazione è .NET Framework 3.5. Per ulteriori informazioni, vedere Progettazione e creazione di soluzioni Office.

Riferimenti agli assembly

Visual Studio aggiorna i seguenti riferimenti all'assembly nel progetto:

• Assembly di interoperabilità primari di Microsoft Office.

• Assembly in Runtime di Visual Studio Tools per Office. Per ulteriori informazioni su tali assembly, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

• Versioni nuove o aggiornate degli assembly dipendenti.

Visual Studio non aggiunge riferimenti a versioni nuove o aggiornate di assembly aggiunti dopo la creazione del progetto originale. Ad esempio, se si aggiorna un progetto relativo al componente aggiuntivo di Word 2003 che fa anche riferimento all'assembly di interoperabilità primario di PowerPoint 2003, Visual Studio modifica il progetto aggiornato affinché faccia riferimento all'assembly di interoperabilità primario di Word 2007 o Word 2010. Tuttavia, è necessario aggiornare manualmente il riferimento all'assembly di interoperabilità primario di PowerPoint.

Aggiornamento dei progetti Microsoft Office 2003

Per impostazione predefinita, se sul computer di sviluppo è installato Microsoft Office 2010 o Microsoft Office System 2007 quando si aggiorna un progetto che ha come destinazione Microsoft Office 2003, Visual Studio modifica il progetto in modo che abbia come destinazione la versione di Microsoft Office installata. La casella di controllo Aggiorna sempre alla versione installata di Office nella pagina delle opzioni Aggiornamento progetto controlla questo comportamento. Se si deseleziona questa casella di controllo, Visual Studio non modifica il progetto per destinarlo a Microsoft Office 2010 o a Microsoft Office System 2007 e potrebbe non essere possibile aprire, eseguire il debug o il progetto. Per ulteriori informazioni su questa opzione, vedere Aggiornamento progetto, finestra di dialogo Opzioni.

Di seguito sono riportate alcune considerazioni aggiuntive per l'aggiornamento delle personalizzazioni a livello di documento e dei componenti aggiuntivi a livello di applicazione destinati a Microsoft Office 2003.

Progetti a livello di documento

Per aggiornare un progetto a livello di documento per Microsoft Office 2003, è necessario disporre dell'applicazione Microsoft Office 2010 o Microsoft Office System 2007 appropriata installata nel computer di sviluppo. Ad esempio, è necessario installare Word 2007 o Word 2010 nel computer prima di poter aggiornare un progetto di Word 2003.

Quando si aggiorna un progetto a livello di documento con un documento salvato in formato binario, è necessario decidere se convertire il documento in un formato Open XML o lasciare il documento in formato binario. In assenza di un motivo specifico per utilizzare il formato precedente, selezionare Open XML. Per ulteriori informazioni sul formato Open XML, vedere Introduzione alle nuove estensioni dei file e ai nuovi formati XML Office.

Se il documento nel progetto contiene controlli Windows Form, è necessario che anche Visual Studio 2005 Tools for Office Second Edition Runtime sia installato prima di aggiornare il progetto. Se la versione del runtime non viene installata nel computer di sviluppo prima dell'aggiornamento del progetto, è possibile che si verifichino errori di compilazione o runtime nel progetto aggiornato. Al termine dell'aggiornamento del progetto, è possibile disinstallare Visual Studio 2005 Tools for Office Second Edition Runtime dal computer di sviluppo se non viene utilizzato da altre soluzioni Office. La versione di runtime è disponibile come pacchetto ridistribuibile nell'Area download Microsoft in Microsoft Visual Studio 2005 Tools for Office Second Edition Runtime (VSTO 2005 SE) (x86).

Progetti a livello di applicazione

Se nel file della soluzione per il progetto originale era incluso un progetto di installazione configurato per installare il componente aggiuntivo a livello di applicazione, Visual Studio aggiorna il progetto di installazione a un progetto Visual Studio 2010, ma non apporta alcuna ulteriore modifica al progetto. Se si desidera continuare a utilizzare un file di Windows Installer per distribuire il componente aggiuntivo, è necessario modificare il progetto di installazione per installare i nuovi prerequisiti quali .NET Framework 4 o .NET Framework 3.5, Visual Studio 2010 Tools per Office Runtime e facoltativamente gli assembly di interoperabilità primari a cui fa riferimento il componente aggiuntivo. Per ulteriori informazioni, vedere Distribuzione di una soluzione Office tramite Windows Installer.

Se si desidera utilizzare ClickOnce per distribuire il componente aggiuntivo, è possibile eliminare completamente il progetto di installazione. Per ulteriori informazioni sulla distribuzione di componenti aggiuntivi tramite ClickOnce, vedere Distribuzione di soluzioni Office.

Vedere anche

Attività

Procedura: aggiornare soluzioni Office

Riferimenti

Aggiornamento progetto, finestra di dialogo Opzioni

Concetti

Migrazione di soluzioni Office a .NET Framework 4