Automatic Migration ASP.Net 1.1 to ASP.Net 2.0
Note: In case you are trying it on your own project, please make sure your Code
Auditor report is zero.
Setup your sample project
- Normally the Code Auditor ASP.NET 2.0 migration sample Virtual Directory is created
for you by the setup package. If not (or you need to recreated the sample migration
virtual directory), go to SSW Code Auditor Samples in your start menu or go to the
C:\Program Files\SSW Code Auditor\samples\ASPMigration.
- Right click on the ASPMigration folder, go to Sharing and Security -> Web Sharing.
Figure: Enable web sharing
- Select share this folder and add an Alias name. For example ASPMigration.
Figure: Add share folder
Figure: Setup Alias name
- Open the Solution file (ASPMigration.sln) in Visual Studio 2003 and confirm that
Figure: Compile your application in Visual Studio 2003 first
Note: As a general rule for any ASP.NET migration, you should make
- Your ASP.NET 1.1 web application compiles in Visual Studio 2003 before attempting
- You have removed any pages that are not used anymore. e.g. zzBasket.aspx or _Basket.aspx_old
- TIP: If you have a small website, you can precompile your whole web site using hidden
function of ASP.NET 1.1. See the details.
This ensures that all page directives and server tags in your aspx pages are valid.
This is not done by the VS 2003 compiler.
- Go to your browser and go to this location http://localhost/ASPMigration/Default.aspx.
Figure: Open http://localhost link
- Now this is your ASP.Net 1.1 test application.
(Optional) We can run Code Auditor rule ASP 2.0 Migration Prerequisite. This step
is optional because it is not critical for the compilation of the migrated site
This step will list:
process. These can be manually migrated at a later. The report can be used for future
- Recommended directory locations (e.g. all ascx files should be in the /Components
We will start the migration to ASP.Net 2.0 using Code Auditor now.
- The built-in Microsoft VS 2005 ASP.NET 2.0 migration wizard does not take advantage
of Master pages, you need to create them manually.
Let's see how Code Auditor help us to take advantage of master pages automatically
in ASP.Net 2.0.
- Start Code Auditor Application and choose the job "Migrating to ASP.Net2".
- Check the scanning folder is your virtual path that you just created.
Figure: Check folder path
Note: If you have aspx pages or ascx files (controls) in subdirectories of your
ASP.NET 1.1 web solution, make sure that you check on the "Search Subfolders"
option when choosing the path to scan - otherwise it will not convert these files
Figure: Ensure that subfolders are checked on if you want to migrate your controls
and pages in subdirectories as well
- Run the Scan in Code Auditor.
Figure: Scan the project
- Replacement Screen come up.
Warning! if you doing this on your live project please make sure you backup all
- Click on the replace button. You will have a list of options. You can replace them
one by one or you can replace them all in one click.
In this example we recommended you to click Replace All.
Figure: Replace All button
Figure: List of replacement buttons
- After that you can view your report. It will show all the lines that have been modified
by Code Auditor
- To Ensure your Migration is successful. You need to make sure Code Auditor report
Please click back button and run the scan again.
Figure: Zero warnings in Code Auditor report
Because the header (<HEAD></HEAD>) area is in the master page, the following
will typically should be moved into the master page
- Anything between <SCRIPT> </SCRIPT> tags
- Any <LINK HREF > tags
Open the solution in VS 2005 and use the VS 2005 ASP.NET Migration Wizard
- Complete the steps in the wizard.
Figure: VS 2005 migration wizard page 1
Figure: VS 2005 migration wizard page 2
Figure: VS 2005 migration wizard page 3
- Your pages are all using master pages now. Here is what we have done in Code Auditor.
Steps to ASP Migration
- You can swap to designer view see how we are using Master Page now.
Figure: Designer view in VS 2005
Now you have your ASP.Net 2.0 pages ready, but you still need to configure IIS
- When You try to reload the Testing page again you will see the following error,
which means your IIS settings is still on .Net 1.1.
Figure: Error page shows IIS configuration is still on .Net 1.1
- Bring up IIS
Figure: Open IIS in control panel
- Find your Virtual Directory ASPMigration
- Configure the ASP.Net Framework from 1.1 to 2.0
Figure: Change Framework version
- Attempt to compile your project. If you recieve errors in your temporary ASP.NET
2.0 files such as
"c:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files\shoptest3\074c93d5\ccad2056\App_WebReferences.x32dixwx.0.cs(2828,26):
warning CS0436: The type 'SSW.SSWWebService.clsContactFullDetails' in 'c:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Temporary
ASP.NET Files\shoptest3\074c93d5\ccad2056\App_WebReferences.x32dixwx.0.cs' conflicts
with the imported type 'SSW.SSWWebService.clsContactFullDetails' in 'c:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Temporary
when compiling your project, it is recommended that you:
- Stop IIS and close VS 2005
- Go to your ASP.NET 2.0 temporary files (typically C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Temporary
ASP.NET Files) and delete all the folders there
- Now you can refresh your Browser and enjoy ASP.Net 2.0 pages