ASP.NET 2.0 is currently in beta 2 version. Those of you who have been curious to know about the new features in 2.0 and had installed the beta 1 version would have found that many of the ASP.NET applications written in beta 1 don’t even compile in beta 2. This article will help identify the common compile time errors and the changes required to fix them.
Changes in Page Attribute Names
In the aspx file’s @Page directive, two common attributes used are to specify the code-behind file and to specify the class name for the page. The names for these attributes have changed as follows:
Beta 1
WebForm1.aspx: <%@ page CompileWith="webform1.aspx.cs" ClassName="WebForm1 %>
Beta 2
WebForm1.aspx: <@ page CodeFile=webform1.aspx.cs Inherits=WebForm1 %>
Compilation Error Received
The CompileWith/ClassName attributes in the compilation model are no longer supported.
Explicitly Specifying the Base Class
When creating master pages and Web forms through Visual Studio 2005 beta 1, the form class’s base class isn’t specified. When compiling this code in beta 2, compile errors are gotten.
Beta 1
MasterPage.aspx.cs: public partial class MasterPage_master { } // note there is no base class specified WebForm1.aspx.cs: public partial class WebForm1 { } // note there is no base class specified
Beta 2
MasterPage.aspx.cs: public partial class MasterPage_master : System.Web.UI.MasterPage {} WebForm1.aspx.cs: public partial class WebForm1 : System.Web.UI.Page {}
Compilation Error Received
error CS0115:ASP.MasterPage_master.FrameworkInitialize()': no suitable method found to override. Could not find any attribute 'marginheight' of element 'body'
When Using Master Pages, Explicitly Mark the Event Handlers as Protected
Visual Studio 2005 beta 1 does not put any access modifiers for event handlers. Due to this, they are treated as private in beta 2, generating compile time errors.
Beta 1
WebForm1.aspx.cs: void GridView1_Init(object sender, EventArgs e) // note access modifier missing
Beta 2
WebForm1.aspx.cs: protected void GridView1_Init(object sender, EventArgs e)
Compilation Error Received
error CS0122: 'TestDetails_aspx.GridView1_Init(object, System.EventArgs)' is inaccessible due to its protection level.
Change in the Theme Directory Name
In ASP.NET 2.0, the theme files are stored in a special directory. In beta 1, this folder was named “Themes;” in beta 2, the name has been changed to “app_themes.” The names of other special folders have also been changed.
Beta 1
Theme folder : /Themes Database folder : /Data Code folder : /Code
Beta 2
Theme foler : /app_themes Database folder : /app_data Code folder : /app_code
Runtime Error Received
- Invalid theme or stylesheettheme value. - Theme 'theme-name' cannot be found in the application or global theme directories.
Some Useful Links
Visual Studio 2005 Developer Center (this also has a link to “Get Visual Studio 2005 Beta 2”): http://lab.msdn.microsoft.com/vs2005/
If you want to understand why the changes described in this article were made to Beta 2: http://msdn.microsoft.com/asp.net/beta2/beta2update.aspx