CodeFile vs CodeBehind

What is the difference between CodeFile=”file.ascx.cs” and CodeBehind=”file.ascx.cs” in the declaration of a ASP.NET user control?

Is one newer or recommended? Or do they have specific usage?


Thank you for visiting the Q&A section on Magenaut. Please note that all the answers may not help you solve the issue immediately. So please treat them as advisements. If you found the post helpful (or not), leave a comment & I’ll get back to you as soon as possible.

Method 1

CodeBehind: Needs to be compiled (ASP.NET 1.1 model). The compiled binary is placed in the bin folder of the website. You need to do a compile in Visual Studio before you deploy. It’s a good model when you don’t want the source code to be viewable as plain text. For example when delivering to a customer to whom you don’t have an obligation to provide code.

CodeFile: You provide the source file with the solution for deployment. ASP.NET 2.0 runtime compiles the code when needed. The compiled files are at Microsoft.NET[.NET version]Temporary ASP.NET Files.

Method 2

I’m working with an Application Project in Visual Studio Express 2012 For Web and using .NET 4.0. In the code behind files for my login and change password pages I found a situation where I needed both CodeBehind and CodeFile in the declaration.

If I don’t add a code file reference like


The web page doesn’t parse and the browser displays a parser error. It doesn’t matter whether I compile the project or not.

If I don’t add a code behind reference like


References to Security classes like MembershipUser fail both at compile time and when attempting to use intellisense with an error like “The type or namespace MembershipUser cannot be found”. I have added a reference to System.Web.ApplicationServices as required by the .Net 4.0 framework.

I should add that these troublesome files are running in an application within the website created using the IIS Application tool. When I open the website from Visual Studio I have no difficulty with parser errors or reference errors. This confusion only occurs when I open the application as a project in Visual Studio.

Method 3

Codebehind file need to compile before run but in src we dont need to compile and then run.. just save the file.

All methods was sourced from or, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0

0 0 votes
Article Rating
Notify of

Inline Feedbacks
View all comments
Would love your thoughts, please comment.x