Procedura dettagliata: conversione di un progetto Web di Visual Studio .NET 2003 in un progetto di applicazione Web di Visual Studio

Articolo
10/22/2014

Aggiornamento: novembre 2007

La conversione di un progetto Web di Visual Studio .NET 2003 in un progetto di applicazione Web di Visual Studio 2008 consente di avvalersi delle funzionalità di Visual Studio 2008, tra cui refactoring, diagrammi di classi, sviluppo di test e generics. Il modello di progetto di applicazione Web rende inoltre disponibili tutte le funzionalità di ASP.NET 2.0 e versioni successive, tra cui le pagine master, i controlli dati, i controlli di appartenenza e di accesso, la gestione dei ruoli, le Web part, la personalizzazione, l'esplorazione del sito e i temi.

Il modello di progetto di applicazione Web di Visual Studio 2008 è più simile al modello di progetto disponibile per le applicazioni di Visual Studio .NET 2003 e ciò risulta utile nella conversione di un progetto Web di Visual Studio .NET 2003 in Visual Studio 2008. Per ulteriori informazioni sulle nuove funzionalità, vedere Novità di ASP.NET e dello sviluppo Web.

Nota:
I progetti di applicazione Web ASP.NET possono essere creati mediante Visual Studio o Visual Web Developer Express Edition.

In questa procedura dettagliata viene descritto come convertire un progetto Web di Visual Studio .NET 2003 esistente in un progetto di applicazione Web in Visual Studio 2008. Per il modello di progetto di applicazione Web vengono applicati gli stessi concetti che sono alla base dei progetti Web in Visual Studio .NET 2003, tra cui l'utilizzo di un file di progetto per includere ed escludere i file e la compilazione in un unico assembly. Per ulteriori informazioni, vedere Conversione di progetti Web da Visual Studio .NET.

Nota:
Per convertire un sito Web in cui viene utilizzato Microsoft Office FrontPage 2003 in un progetto di applicazione Web, convertire innanzitutto il sito Web di FrontPage in un progetto di sito Web°di°Visual Studio 2008. Convertire quindi il progetto di sito Web in un progetto di applicazione Web. Per ulteriori informazioni, vedere Procedura dettagliata: conversione di un progetto di sito Web in un progetto di applicazione Web in Visual Studio.

Per convertire un sito Web in cui viene utilizzato Microsoft Office FrontPage 2003 in un progetto di applicazione Web, convertire innanzitutto il sito Web di FrontPage in un progetto di sito Web°di°Visual Studio 2008. Convertire quindi il progetto di sito Web in un progetto di applicazione Web. Per ulteriori informazioni, vedere Procedura dettagliata: conversione di un progetto di sito Web in un progetto di applicazione Web in Visual Studio.

Di seguito vengono illustrate le attività incluse nella procedura dettagliata:

Apertura e verifica del progetto Web di Visual Studio .NET 2003.
Esecuzione del backup del progetto Web di Visual Studio .NET 2003.
Conversione del progetto Web di Visual Studio .NET 2003 in Visual Studio 2008.
Verifica del progetto di applicazione Web in Visual Studio 2008.
Conversione di classi code-behind in classi parziali.
Esame e risoluzione dei problemi di compatibilità con XHTML.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei seguenti elementi:

Visual Studio .NET 2003
Visual Studio 2008 o Visual Studio 2005 Service Pack 1 (SP1) oppure Visual Web Developer Express Edition
.NET Framework versione 2.0

Apertura e verifica del progetto Web di Visual Studio .NET 2003

Prima di convertire un progetto si consiglia di verificare che funzioni correttamente. In questo modo si eviteranno errori durante la conversione.

Per aprire e verificare il progetto Web di Visual Studio .NET 2003

Aprire Visual Studio .NET 2003.
Scegliere Apri file dal menu File, quindi digitare o individuare il file sln relativo alla soluzione da verificare.

Nota:

In Visual Studio .NET 2003, i file che costituiscono il progetto sono inclusi in un file di soluzione (sln).
Scegliere Compila soluzione dal menu Progetto.
Scegliere Avvia dal menu Debug.
Verificare che il progetto venga eseguito come previsto.

Nota:
In Visual Studio .NET 2003, i file che costituiscono il progetto sono inclusi in un file di soluzione (sln).

Esecuzione del backup del progetto Web di Visual Studio .NET 2003

È opportuno eseguire il backup della soluzione e dei file di progetto di Visual Studio .NET 2003 prima di avviare il processo di conversione. Se si verificano problemi durante la conversione, sarà possibile ripristinare la soluzione di Visual Studio .NET 2003.

Per eseguire il backup del progetto, copiarlo in Visual Studio .NET 2003.

Per eseguire il backup del progetto Web di Visual Studio .NET 2003 prima della conversione

Aprire Visual Studio .NET 2003.
Scegliere Apri file dal menu File, quindi digitare oppure individuare il file sln relativo alla soluzione per la quale si intende eseguire il backup.
Scegliere Copia progetto dal menu Progetto.
Nella casella Copia progetto, selezionare Cartella progettodi destinazione.
Selezionare un'opzione Metodo di accesso Web. È possibile utilizzare FrontPage o Condivisione file per copiare i file.
Selezionare l'opzione Includi tutti i file nella cartella di progetto, quindi scegliere OK.

Conversione del progetto Web di Visual Studio .NET 2003 in Visual Studio 2008

Con Visual Studio 2008 la soluzione e i file di progetto di Visual Studio .NET 2003 vengono convertiti per fare in modo che venga utilizzato il formato di Microsoft Build Engine (MSBuild), ovvero il formato dei file di progetto di Visual Studio 2008.

Durante il processo di conversione in Visual Studio 2008 viene generato un file di log, basato su XML, in cui è fornito un riepilogo della conversione e vengono contrassegnati gli eventuali problemi. Per impostazione predefinita, tale file di registro viene salvato nella stessa directory del file sln. Se si verificano problemi durante la compilazione del progetto convertito, è possibile fare riferimento al file di log di conversione.

Per convertire il progetto Web in Visual Studio 2008

In Visual Studio .NET 2003 chiudere il file della soluzione.
Aprire Visual Studio 2008.
Scegliere Apri file dal menu File, quindi digitare o individuare il file sln relativo alla soluzione da convertire.

Verrà visualizzata la conversione guidata di Visual Studio 2008.
Fare clic su Avanti, seguire le istruzioni per completare la procedura guidata, quindi fare clic su Fine.

Verifica del progetto di applicazione Web in Visual Studio 2008

Dopo la conversione della soluzione e dei file di progetto nel formato di Visual Studio 2008, verificare se l'applicazione viene compilata senza errori ed eseguita in modo corretto.

Per verificare il progetto di applicazione Web in Visual Studio 2008

In Visual Studio 2008 scegliere Apri file dal menu File, quindi digitare o individuare il file sln relativo alla soluzione da verificare.
Scegliere Compila soluzione dal menu Progetto.
Scegliere Avvia dal menu Debug.
Verificare che il progetto di applicazione Web venga eseguito senza problemi.

Errori e avvisi comuni

Di seguito vengono elencati i tipi più frequenti di errori o avvisi visualizzati durante il processo di conversione:

Conflitti con i nomi introdotti in .NET Framework versione 2.0.
Avvisi relativi a membri obsoleti.
Problemi che si verificano durante l'esecuzione dell'applicazione Web.

Per risolvere i conflitti di denominazione è possibile eliminare l'ambiguità completando i nomi esistenti con uno spazio dei nomi oppure rinominando i tipi e i membri in modo che non siano in conflitto. Per ulteriori informazioni sui conflitti di denominazione, vedere Cenni preliminari sulla migrazione ad ASP.NET 2.0 e Linee guida per la denominazione degli spazi dei nomi.

Nel messaggio di avviso relativo a membri obsoleti vengono in genere suggeriti membri alternativi da utilizzare. In tal caso è possibile continuare a utilizzare i membri obsoleti. Poiché tuttavia i membri verranno rimossi nella prossima principale versione di .NET Framework, è consigliabile rimuoverli e sostituirli con le alternative suggerite.

Se viene visualizzato un messaggio di errore indicante che è impossibile visualizzare il contenuto della directory durante l'esecuzione dell'applicazione Web, è possibile che la directory virtuale dell'applicazione Web non consenta questa operazione. Per risolvere il problema, in Esplora soluzioni fare clic con il pulsante destro del mouse sulla pagina iniziale dell'applicazione e scegliere Imposta come pagina iniziale. In tal modo verrà sicuramente richiamata la pagina corretta durante l'esecuzione dell'applicazione.

Conversione di classi code-behind in classi parziali

In Visual Studio 2008 i progetti di applicazioni Web utilizzano classi parziali per il codice generato da Visual Studio. Tali classi sono archiviate in un file separato dal file code-behind. Per impostazione predefinita, nella conversione guidata di Visual Studio 2008 non viene creato alcun file *.designer.cs oppure *.designer.vb per le pagine Web (file aspx) o per i controlli utente (file ascx). Il codice avrà invece lo stesso aspetto e le stesse funzionalità che possedeva in Visual Studio .NET 2003.

Nota:
Durante il processo di conversione guidata di Visual Studio 2008 verrà apportato il numero minimo possibile di modifiche ai file di codice, al fine di garantire che la conversione al progetto di applicazione Web avvenga senza problemi in Visual Studio 2008.

È possibile mantenere il codice nel formato di Visual Studio .NET 2003. In tal caso sarà necessario aggiornare manualmente le dichiarazioni dei campi di controllo nei file code-behind, come precedentemente fatto in Visual Studio .NET 2003. Tuttavia, per poter sfruttare la possibilità di mantenere le dichiarazioni dei campi nel codice generato, è necessario aggiornare le pagine e i controlli affinché utilizzino il modello di classe parziale. Le classi parziali facilitano l'organizzazione del codice generato e del codice personalizzato per i file code-behind. Per ulteriori informazioni, vedere Partial (Visual Basic) e parziale (Tipo) (Riferimenti per C#).

Per convertire il codice affinché utilizzi il modello di classe parziale

Assicurarsi che il codice venga compilato correttamente.

In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto e scegliere Converti in applicazione Web.

Questo comando viene ripetuto in ogni pagina e ogni controllo utente del progetto, spostando tutte le dichiarazioni dei controlli in un file .designer.cs o .designer.vb. Aggiunge inoltre dichiarazioni di gestori eventi nel markup del controllo server dei file aspx e ascx.

Nota:
È possibile utilizzare il comando Converti in applicazione Web in pagine singole. È possibile eseguire il comando inizialmente solo su alcune pagine, al fine di verificare le modifiche apportate a ogni pagina prima di estenderle a tutta l'applicazione.

Non è possibile annullare l'effetto del comando Converti in applicazione Web. La soluzione migliore per ripristinare le modifiche consiste nell'utilizzare un backup del progetto di Visual Studio .NET 2003 e nell'eseguire nuovamente la conversione in Visual Studio 2008, come descritto in precedenza.

Al termine del processo, verificare se nella finestra Elenco attività sono visualizzati eventuali errori di conversione.

Se nella finestra Elenco attività sono visualizzati degli errori, fare clic con il pulsante destro del mouse sulla relativa pagina in Esplora soluzioni, quindi selezionare Visualizza codice e Visualizza file generazione codice per esaminare il codice e risolvere i problemi.

Nota:
Gli errori e gli avvisi visualizzati nella finestra Elenco attività vengono mantenuti da una sessione all'altra di Visual Studio. Dopo avere corretto gli errori elencati nella finestra, è possibile cancellare gli elementi dall'elenco di attività.

Ricompilare il progetto per verificare che tale operazione non generi errori.

Da questo momento, per impostazione predefinita le nuove pagine aggiunte al progetto Web utilizzeranno il modello di classe parziale. Per ulteriori informazioni, vedere Cenni preliminari sulla migrazione ad ASP.NET 2.0.

Esame e risoluzione dei problemi di compatibilità con XHTML

Per impostazione predefinita, il markup generato e convalidato in Visual Studio 2008 è compatibile con XHTML. Ciò consente di compilare applicazioni Web compatibili con gli standard e di minimizzare i problemi di rendering specifico del browser. Per impostazione predefinita in Visual Studio .NET 2003 non viene creato markup compatibile con XHTML. Per questo motivo, in seguito alla conversione dell'applicazione Web in Visual Studio 2008 potrebbero verificarsi problemi di convalida e di rendering relativi alle pagine create in Visual Studio .NET 2003.

Nota:
Gli errori di convalida hanno solo valenza informativa e vengono contrassegnati come avvisi. Tali errori non impediscono a una pagina di essere eseguita.

Se si desidera visualizzare gli errori di convalida HTML come in Visual Studio .NET 2003, passare dall'impostazione di convalida HTML XHTML transizionale all'impostazione Internet Explorer 6.0. Internet Explorer 6.0 è l'impostazione predefinita per la convalida HTML in Visual Studio .NET 2003. Per ulteriori informazioni, vedere Procedura: selezionare gli schemi di convalida per la modifica HTML in Visual Web Developer.

È inoltre possibile aggiungere la sezione seguente al file Web.config del progetto, per fare in modo che in ASP.NET venga eseguito il rendering del markup legacy (non compatibile con XHTML) dei controlli server:

<system.Web>
  <xhtmlConformance mode="Legacy" />
</system.Web>

In questo modo sarà possibile evitare le lievi differenze di rendering riscontrabili tra le pagine visualizzate con ASP.NET 1.1 e le pagine visualizzate con ASP.NET 2.0. Si noti che è necessario modificare la modalità xhtmlConformance solo per risolvere eventuali problemi di conversione. Quando il progetto di applicazione Web viene eseguito correttamente, rimuovere l'impostazione di configurazione legacy. Per ulteriori informazioni, vedere ASP.NET e XHTML e Cenni preliminari sulla migrazione ad ASP.NET 2.0.

Vedere anche

Condividi tramite