Aggiornamento e migrazione di soluzioni Office
Aggiornamento: novembre 2007
Utilizzare la Conversione guidata di Visual Studio per aggiornare i progetti da Visual Studio Tools per Office, versione 2003 e Microsoft Visual Studio 2005 Tools per Microsoft Office System a Visual Studio Tools per Microsoft Office System 3.0. Per aggiornare una soluzione Microsoft Office, aprire la soluzione in Visual Studio con Visual Studio Tools per Microsoft Office System 3.0 installato. La Conversione guidata di Visual Studio viene visualizzata e indica i passaggi necessari per completare l'aggiornamento. Per ulteriori informazioni, vedere Procedura: aggiornare soluzioni da Visual Studio Tools per Office.
La procedura guidata non modifica il codice. Se si aggiorna un progetto di componente aggiuntivo per Outlook 2003, è possibile che sia necessario aggiornare il codice manualmente. Per ulteriori informazioni, vedere Progetti Outlook.
Riferimenti agli assembly
La Conversione guidata di Visual Studio aggiorna il file di progetto e il riferimento all'assembly di interoperabilità primario dell'applicazione principale di Microsoft Office per la soluzione. Aggiunge, inoltre, i riferimenti a versioni nuove o aggiornate di assembly dipendenti. Tuttavia, la procedura guidata non aggiunge i riferimenti a versioni nuove o aggiornate di assembly che vengono aggiunti manualmente al progetto dopo che il progetto originale è stato creato.
Ad esempio, se si aggiorna un progetto di componente aggiuntivo per Word 2003 che ha riferimenti a un assembly del metodo di supporto e all'assembly di interoperabilità primario di PowerPoint, la Conversione guidata di Visual Studio assicura che i riferimenti all'assembly di interoperabilità primario di Word e all'assembly di supporto siano corretti. Tuttavia, è necessario aggiornare manualmente il riferimento all'assembly di interoperabilità primario di PowerPoint.
Aggiornamenti di versioni
Per impostazione predefinita, se è installato Microsoft Office System 2007, la procedura guidata aggiorna i progetti Microsoft Office 2003 in modo che diventino progetti per Microsoft Office System 2007. Tuttavia, il processo relativo alle personalizzazioni a livello di documento e ai componenti aggiuntivi a livello di applicazione è diverso.
Progetti di personalizzazione a livello di documento
Se si sta aggiornando una personalizzazione a livello di documento, non c'è modo di evitare che la procedura guidata aggiorni la versione del progetto in quanto la finestra di progettazione che viene visualizzata quando si apre una personalizzazione a livello di documento utilizza la versione di Office attualmente installata. Il progetto viene aperto nella finestra di progettazione solo se corrisponde alla versione di Office installata.
Per aggiornare un progetto di personalizzazione a livello di documento è necessario avere la corretta applicazione di Office installata. Ad esempio, è necessario avere Word 2003 o Word 2007 installato nel computer prima che sia possibile aggiornare un progetto di personalizzazione a livello di documento per Word 2003.
Se è installato Microsoft Office System 2007, la Conversione guidata di Visual Studio richiede di scegliere se convertire o meno il documento in uno dei formati Open XML. In assenza di un motivo specifico per utilizzare il formato precedente, convertire il formato del documento. Per ulteriori informazioni sui formati, vedere Introduzione alle nuove estensioni di nomi dei file e ai formati Open XML.
Se è installato Microsoft Office 2003 quando si aggiorna il progetto, il progetto continuerà a utilizzare Microsoft Office 2003 come la versione di destinazione e il formato del documento rimarrà lo stesso.
Se si aggiorna un progetto a livello di documento creato in Visual Studio Tools per Office, versione 2003, è necessario eseguire alcuni passaggi di aggiornamento manualmente. Per ulteriori informazioni, vedere la classe Aggiornamento da Visual Studio Tools per Office, versione 2003.
Progetti di componente aggiuntivo a livello di applicazione
Se è installato Microsoft Office System 2007 e non si desidera che la Conversione guidata di Visual Studio aggiorni i progetti di componente aggiuntivo dalla versione 2003 alla versione 2007, è possibile modificare l'impostazione predefinita in modo che rimangano progetti di Office 2003. Dal momento che la versione 2007 di Office 2007 può contenere i componenti aggiuntivi 2003, è possibile sviluppare, compilare testare il progetto anche se Microsoft Office 2003 non è installato. Deselezionare l'opzione Aggiorna sempre alla versione installata di Office nella pagina delle opzioni Aggiornamento progetto. Per ulteriori informazioni, vedere Aggiornamento progetto, finestra di dialogo Opzioni.
La Conversione guidata di Visual Studio non può rendere compatibili progetti di componente aggiuntivo con una versione precedente di Office. Pertanto, se è installato Office 2003 e si aggiorna un progetto di componente aggiuntivo versione 2007, dopo l'aggiornamento il progetto rimane un progetto di componente aggiuntivo versione 2007. È possibile aprire il progetto, sviluppare il componente aggiuntivo e compilare il codice, ma non è possibile testare il componente aggiuntivo perché Office 2003 non fornisce componenti aggiuntivi per la versione 2007.
Non è necessario installare Microsoft Office per aggiornare un progetto di componente aggiuntivo a livello di applicazione.
Progetti di Outlook
Se si aggiorna un progetto di componente aggiuntivo per Outlook 2003, è necessario aggiornare il nome della classe dell'elemento host e i riferimenti all'oggetto Microsoft.Office.Interop.Outlook.Application.
.gif "Nota") Nota: |
|---|
Non è necessario aggiornare i progetti creati con i modelli di progetto Microsoft Visual Studio 2005 Tools per Microsoft Office System 2007 (VSTO 2005 SE). |
Nome della classe dell'elemento host
La Conversione guidata di Visual Studio non aggiorna il nome della classe dell'elemento host. Il nome della classe continua a essere ThisApplication. Non è necessario modificare questo nome. Tuttavia, gli esempi di codice nella Guida di Visual Studio Tools per Microsoft Office System 3.0 utilizzano il nome della classe dell'elemento host ThisAddIn. Per rendere più semplice il test del codice copiando e incollando il codice nel progetto, è possibile impostare il nome della classe su ThisAddIn ed effettuare il refactoring di questa modifica del nome in tutto il progetto. Per informazioni sul refactoring del codice in un progetto a C#, vedere Procedura: rinominare gli identificatori. Per informazioni sul refactoring del codice in un progetto Visual Basic, vedere Procedura: rinominare un identificatore.
Riferimenti all'oggetto applicazione
La Conversione guidata di Visual Studio non modifica il codice. Di conseguenza, è necessario modificare manualmente tutto il codice che utilizza una delle tecniche seguenti per accedere all'oggetto Microsoft.Office.Interop.Outlook.Application:
La parola chiave this (in C#) o Me (in Visual Basic) nella classe ThisApplication.
L'oggetto Globals.ThisApplication nel codice esterno alla classe ThisApplication.
Ad esempio, se la classe ThisApplication contiene il seguente codice, è necessario aggiornarla.
Me.ActiveExplorer()
this.ActiveExplorer();
Il codice seguente funziona come sostituzione nei progetti aggiornati.
Me.Application.ActiveExplorer()
This.Application.ActiveExplorer();
La classe dell'elemento host ThisApplication nei progetti Microsoft Visual Studio 2005 Tools per Microsoft Office System eredita direttamente dalla classe Microsoft.Office.Tools.Outlook.Application. Tuttavia, la classe dell'elemento host ThisAddIn nei progetti Visual Studio Tools per Microsoft Office System 3.0 non eredita da Microsoft.Office.Tools.Outlook.Application. Fare invece riferimento all'oggetto applicazione attivo utilizzando la proprietà Application della classe dell'elemento host.
Aggiornamento alla versione 2007 di Microsoft Office
Se si aggiorna alla versione 2007 di Microsoft Office dopo avere aggiornato un progetto Visual Studio Tools per Office, la Conversione guidata di Visual Studio verrà visualizzata alla successiva apertura del progetto.
I progetti di componente aggiuntivo per la versione 2007 di Office che si è scelto di non aggiornare al momento dell'installazione di Office 2003 vengono ora eseguiti e possono essere testati premendo F5 o CTRL+F5 in Visual Studio.
Vedere anche
Attività
Procedura: aggiornare soluzioni da Visual Studio Tools per Office
Concetti
Aggiornamento da Visual Studio Tools per Office, versione 2003