Conversione di progetti Web da Visual Studio .NET

Articolo
10/22/2014

Aggiornamento: novembre 2007

In Microsoft Visual Studio 2005, i file e i progetti dei siti Web sono gestiti in modo diverso rispetto a Visual Studio .NET 2002 e a Visual Studio .NET 2003 (nella parte restante di questo argomento saranno indicati collettivamente come Visual Studio .NET). Di conseguenza, in caso di utilizzo di Visual Studio 2005 per un progetto creato in Visual Studio .NET, sarà necessario convertire tale progetto in un progetto di applicazione Web. Tale processo viene eseguito in modo automatico quando un progetto di Visual Studio .NET viene aperto in Visual Studio 2005. Mediante la Conversione guidata, l'applicazione Web verrà convertita e le modifiche manuali necessarie per terminare la conversione saranno ridotte al minimo. In questo argomento viene descritto il processo di conversione e sono specificate le modifiche apportate nei file di Visual Studio .NET. Per ulteriori informazioni sui progetti di applicazione Web, vedere Cenni preliminari sui progetti di applicazione Web.

Lo scopo globale del processo di conversione è di consentire l'apertura di un progetto di Visual Studio .NET in Visual Studio 2005, convertirlo in modo automatico e, infine, eseguirlo senza apportare alcuna modifica alla funzionalità. Il processo di conversione è irreversibile: un progetto convertito in Visual Studio 2005 non può più essere utilizzato in Visual Studio .NET. Sebbene in Visual Studio 2005 vengano apportate modifiche ai file di un progetto, è possibile effettuare delle copie di backup dei file originali. I file di Visual Studio 2005 potranno comunque essere aperti in Visual Studio .NET come file autonomi (senza alcune funzionalità, ad esempio IntelliSense), tuttavia il progetto globale sarà modificato. Se necessario, è possibile ripristinare il progetto di Visual Studio dai file di backup.

Nota sulla sicurezza:
Prima di convertire un progetto esistente in Visual Studio 2005, esaminare tutti i file esistenti, soprattutto se le modifiche al progetto sono state apportate anche da altri utenti. Ricercare i file esterni. Tale procedura consente la protezione dall'importazione di codici dannosi in Visual Studio. In genere, si consiglia di eseguire Visual Studio 2005 come utente normale e non come amministratore, a meno che non sia necessario eseguire attività amministrative.

Prima di convertire un progetto esistente in Visual Studio 2005, esaminare tutti i file esistenti, soprattutto se le modifiche al progetto sono state apportate anche da altri utenti. Ricercare i file esterni. Tale procedura consente la protezione dall'importazione di codici dannosi in Visual Studio. In genere, si consiglia di eseguire Visual Studio 2005 come utente normale e non come amministratore, a meno che non sia necessario eseguire attività amministrative.

In questo argomento sono incluse informazioni sugli aspetti riportati di seguito relativi alla conversione di progetti Web in Visual Studio 2005.

Processo di conversione in Visual Studio 2005
Soluzioni e progetti
Conversione delle impostazioni di progetto
Conversione di configurazioni specifiche
Componenti dati
Moduli di codice
Servizi Web
Conversione e controllo del codice sorgente

Processo di conversione in Visual Studio 2005

Nell'elenco riportato di seguito è delineato il processo di conversione di progetti Web di base da Visual Studio .NET a Visual Studio 2005.

In Visual Studio 2005, aprire un sito Web Visual Studio NET esistente. È possibile aprire uno qualsiasi dei file e delle directory riportati di seguito:
- File di soluzione (sln)
- File di progetto (vbproj, csproj, o vjp)
- Directory principale del sito Web
Se viene trovato un file di progetto, in Visual Studio 2005 sarà richiamata la Conversione guidata per convertire il progetto Web.

Nota:

Nei progetti Web di Visual Studio 2005 i file di progetto non sono più necessari. Tutti i file contenuti nella cartella del progetto Web sono considerati parte di tale progetto.

Per informazioni dettagliate sui passaggi della Conversione guidata, vedere Procedura: convertire un progetto di Visual Studio .NET in Visual Studio 2005.
In Visual Studio 2005, l'applicazione Web passa dall'utilizzo di ASP.NET versione 1.x all'utilizzo di ASP.NET versione 2.0. Ad esempio, l'attributo CodeBehind presente nelle pagine Web ASP.NET e nei controlli utente viene modificato nell'attributo CodeFile. Se un file viene modificato, le autorizzazioni originali del file non vengono mantenute: il nuovo file disporrà di autorizzazioni di lettura/scrittura concesse agli utenti. Per ulteriori informazioni sulle modifiche apportate ai file, vedere Conversione dei file di progetti e soluzioni Web.
I file di classe autonomi vengono spostati nella directory App_Code.
Gli altri tipi di file non vengono modificati. Tra questi i file di immagini, HTML e così via. Inoltre, il processo di migrazione ignora i file esterni all'applicazione, evitando che utenti non autorizzati possano accedervi utilizzando percorsi relativi in un file di progetto.
Viene creato un report denominato ConversionReport.txt, che viene memorizzato nella directory principale del progetto Web convertito. Nel file di report sono elencate tutte le modifiche apportate al progetto Web e possono essere inclusi commenti informativi, avvisi ed errori individuati in fase di conversione. Se si seleziona l'opzione della Conversione guidata per la visualizzazione del log della conversione dopo il completamento della procedura guidata, in Visual Studio 2005 verrà visualizzato un report di conversione. Per ulteriori informazioni sul formato di tale report, vedere Formato del report di conversione della migrazione.

Nota:
Nei progetti Web di Visual Studio 2005 i file di progetto non sono più necessari. Tutti i file contenuti nella cartella del progetto Web sono considerati parte di tale progetto.

Nota:
Se nel progetto è utilizzato il controllo origine, i file del progetto Web, dopo essere stati convertiti in Visual Studio 2005 non si troveranno nel controllo origine.

Soluzioni e progetti

Se si apre un file di soluzione in Visual Studio 2005, verrà esaminato il contenuto del file SLN per determinarne i tipi di progetti contenuti. In Visual Web Developer saranno convertite soltanto le applicazioni Web (pagine Web e servizi Web). Se si apre un file di soluzione in cui sono contenuti altri tipi di progetti, ad esempio progetti Windows Form o applicazioni di console, soltanto i progetti Web verranno aperti e convertiti.

Se si apre un file di progetto, in Visual Studio 2005 vengono convertiti i file a cui si fa riferimento in quel progetto. Non viene eseguito alcun tentativo di convertire i file presenti nella stessa directory dei file di progetto che non sono parte del progetto. In questo modo, è possibile che vengano generati degli errori. Ad esempio, se è presente un file denominato Page1.aspx e un file di codice sottostante denominato Page1.aspx.cs contenuto nella cartella ma non incluso nel file di progetto, la procedura guidata per la conversione non consentirà la conversione di nessuno dei due file. In fase di compilazione, saranno generati errori dal momento che entrambi i file Page1.aspx e Page1.aspx.cs saranno considerati parte dell'applicazione Web convertita.

Se nel progetto sono contenute directory con nomi riservati in Visual Studio 2005, ad esempio App_Data o App_GlobalResources, in Visual Studio 2005 viene aggiunto il suffisso "_old" ai nomi di directory esistenti (ad esempio, App_Data_old). Per risolvere le eventuali interruzioni di riferimenti conseguenti a tale comportamento, è necessario modificare in manualmente il codice in modo da fare riferimento alla nuova directory oppure spostarlo nelle directory riservate, ad esempio App_Data oppure App_GlobalResources. Per ulteriori informazioni, vedere Cartelle di codice condivise nei siti Web ASP.NET.

Conversione delle impostazioni di progetto

Dal momento che in Visual Studio 2005 non vengono mantenute le impostazioni nei file di progetto, le impostazioni per i progetti di Visual Studio .NET vengono convertite nel file Web.config oppure non vengono convertite se non si applicano in Visual Studio 2005 nel modo in cui venivano applicate in Visual Studio .NET.

Per informazioni dettagliate, vedere Conversione delle impostazioni di progetti Web.

Conversione di configurazioni specifiche

Se nel progetto di origine è contenuta una configurazione della build personalizzata, nel processo di conversione verrà richiesto di selezionare la configurazione da convertire. In questo modo si determinano le impostazioni del progetto utilizzate durante la conversione per la configurazione del sito Web nel nuovo formato.

Se nel progetto di origine sono contenute soltanto configurazioni della build predefinite (release e debug), nel processo di conversione saranno utilizzate le impostazioni presenti nella configurazione di debug.

Componenti dati

Il modello per aggiungere l'accesso ai dati alle pagine Web è stato modificato in Visual Studio 2005. Sebbene in Visual Studio 2005 siano ancora utilizzati componenti di ADO.NET per l'accesso ai dati, nelle pagine di Visual Studio 2005 l'accesso ai dati viene controllato mediante i controlli origine dati, in cui sono incapsulati oggetti connessione dati, oggetti comando dati e dataset oppure lettori dati. Per ulteriori informazioni, vedere Cenni preliminari sui controlli origine dati e Cenni preliminari sulle espressioni di associazione dati.

Il modello Visual Studio .NET di utilizzo di istanze esplicite di connessione dati, comandi dati e dataset è ancora supportato in Visual Studio 2005. Quando in Visual Studio 2005 vengono convertiti pagine o file relativi all'accesso ai dati, gli oggetti dati esistenti vengono convertiti senza essere modificati e continuano a funzionare in Visual Studio 2005 nello stesso modo in cui funzionavano in Visual Studio .NET. Tuttavia, non sarà possibile utilizzare questi componenti di dati nella finestra di progettazione della pagina Web di Visual Studio 2005 (visualizzazione Progettazione) dal momento che tali oggetti non sono supportati dalla finestra di progettazione. Tuttavia possono essere ancora utilizzati in visualizzazione Origine.

Dataset

Durante la conversione, in Visual Studio 2005 lo schema (un file xsd) di un dataset tipizzato viene convertito e memorizzato nella directory App_Code. Il file vb oppure cs, che rappresenta la classe di dataset (generata da Visual Studio), non viene convertito in quanto nel sito Web è possibile fare riferimento al file xsd in modo automatico.

Moduli di codice

I moduli di codice autonomi (file vb e cs) vengono spostati, così come sono, nella directory App_Code. Tale operazione non si applica a file vb e cs associati a pagine Web o ad altri file ASP.NET. Le dichiarazioni di membri contrassegnati come Friend oppure Internal vengono modificate in Public.

Per i file vb, nel processo di conversione viene aggiunta un'istruzione Namespace che punta alla directory principale del progetto Web . Inoltre, durante il processo di conversione vengono aggiunte tutte le classi che non sono state già importate automaticamente da ASP.NET nell'attributo compilerOptions dell'elemento compilatore.

Servizi Web

I servizi Web vengono convertiti essenzialmente nello stesso formato di cui disponevano in Visual Studio .NET. Il file di classe per un servizio Web (il file asmx.vb o asmx.cs) viene spostato nella directory App_Code. I membri contrassegnati come Friend oppure Internal vengono modificati in Public. L'attributo CodeBehind della direttiva @ Page nel file .asmx viene aggiornato per puntare al nuovo percorso del codice.

Nei servizi Web di Visual Basic, al file di classe definito dallo spazio dei nomi principale nel progetto Web, viene aggiunta un'istruzione Namespace. Inoltre durante il processo di conversione viene aggiunta un'istruzione Imports al file Visual Basic per definire tutte le importazioni relative al servizio Web ancora non importate, per impostazione predefinita, da ASP.NET.