All code files (stand-alone, code-behind, and designer class files) in the project are precompiled into a single assembly. By default, this assembly is built and persisted in the Bin folder. Because this compilation model creates a single assembly, you can specify attributes, such as assembly name and version. You can also specify the location of the output assembly. To change the location of the output assembly, in Solution Explorer, right-click the project name, click Properties, and then click the Build tab. On the Build tab is a field named Output Path where you can specify the path to the output assembly.

A Web application project is defined by a project file instead of by a project folder, as is done for a Web site project. The project file references the files that are included in the project, and includes the assembly references and other project metadata settings. Files that are in the project folder but that are not defined in the project file are not compiled as part of the Web application project. Project settings that are added and changed through Visual Studio or Visual Web Developer Express are referenced in the project file (.*proj) that is generated for each project.

To run and debug pages, you must compile the complete Web application project. However, building the complete Web application project can be fast because Visual Studio and Visual Web Developer Express use an incremental build model that builds only the files that have changed.

For more information, see ASP.NET Web Application Projects.

Compiling Class Files

Customizing Compilation Options

By default, only class files of Web application projects are compiled by MSBuild when the Build Action property is set to Compile. However, if a Web application project includes class files in the App_Code folder, those class files will be compiled by ASP.NET. This is true even if their build action is not explicitly set to Compile.

Note
The App_Code folder exists for Web site projects. This folder is not typically included in Web application projects. For more information about the App_Code folder, see Shared Code Folders in ASP.NET Web Site Projects.

Although code files in the project are precompiled into a single assembly by using MSBuild, ASP.NET Web pages (.aspx) and user controls (.ascx) of a Web application project are compiled dynamically on the server by the ASP.NET compiler. This means that you can make limited changes to the ASP.NET Web pages in your site after they have been compiled and deployed. For example, you can change the arrangement of controls, colors, fonts, and other appearance aspects of pages. When the site receives its first request for a page after you have made such a change, ASP.NET recompiles the changed files.

You can define a control in the code-behind file as long as you make it protected or public. Because the .aspx page inherits from the code-behind file, the page will use that control. Moving the definition of a control to the code-behind file is useful in the following situations:

• When the type of the control must be derived from a built-in ASP.NET type.

• When you want a scope for the control other than the default scope. Scope refers to accessibility level, such as public, private, internal, protected and protected internal.

• When you want to add metadata attributes to the declaration of the control.

• When you want to write XML code comments for the declaration of the control.

For more information about how to add controls, see How to: Add Controls to an ASP.NET Web Page Programmatically.

Because all class files are compiled into a single assembly, only that assembly has to be deployed, together with the .aspx and .ascx files and static content files. In this model, the markup in .aspx files is not compiled into runnable code until the page is requested by the browser.

However, you can also compile .aspx files and include them in a single assembly for deployment. For more information about how to deploy Web application projects, see How to: Publish Web Application Projects.

Reference

Concepts

Other Resources