ClientBuildManager.PrecompileApplication Method

Definition

Namespace:

System.Web.Compilation

Assembly:

System.Web.dll

Precompiles an ASP.NET application.

Overloads

PrecompileApplication()	Precompiles an ASP.NET application.
PrecompileApplication(ClientBuildManagerCallback)	Precompiles an ASP.NET application and provides a callback method to receive status information about the build.
PrecompileApplication(ClientBuildManagerCallback, Boolean)	Precompiles an ASP.NET application, provides a callback method to receive status information about the build, and indicates whether to create a clean build.

Remarks

ASP.NET supports three forms of precompilation. One form allows for the in-place precompilation of an ASP.NET application. In this form, the site is deployed to production and then precompiled, which eliminates the need to dynamically compile the site when it is first visited by a user. The first user of the site will not experience the delay normally encountered on a site that is dynamically compiled.

The two other forms of precompilation are used for deployment. In either form, a layout of the site is generated that can be deployed to a production computer. One of these forms includes the markup pages so some amount of updating can be performed on the compiled site. The other form does not contain the markup pages and therefore cannot be updated without recompiling the original site. No source code is deployed to the target environment in either of these forms of precompilation.

The application to precompile is defined through the ClientBuildManager constructor. The ClientBuildManagerParameter object of the ClientBuildManager constructor defines which of the three forms of precompilation to perform.

A developer can precompile a Web site with the aspnet_compiler command-line tool or by calling the PrecompileApplication method.

PrecompileApplication()

Precompiles an ASP.NET application.

public:
 void PrecompileApplication();

public void PrecompileApplication ();

member this.PrecompileApplication : unit -> unit

Public Sub PrecompileApplication ()

Remarks

ASP.NET supports three forms of precompilation. One form allows for the in-place precompilation of an ASP.NET application. In this form, the site is deployed to production and then precompiled, which eliminates the need to dynamically compile the site when it is first visited by a user. The first user of the site will not experience the delay normally encountered on a site that is dynamically compiled.

The two other forms of precompilation are used for deployment. In either form, a layout of the site is generated that can be deployed to a production computer. One of these forms includes the markup pages so some amount of updating can be performed on the compiled site. The other form does not contain the markup pages and therefore cannot be updated without recompiling the original site. No source code is deployed to the target environment in either of these forms of precompilation.

The application to precompile is defined through the ClientBuildManager constructor. The ClientBuildManagerParameter object of the ClientBuildManager constructor defines which of the three forms of precompilation to perform.

A developer can precompile a Web site with the aspnet_compiler command-line tool or by calling the PrecompileApplication method.

See also

• ClientBuildManager
• ASP.NET Web Site Precompilation

PrecompileApplication(ClientBuildManagerCallback)

Precompiles an ASP.NET application and provides a callback method to receive status information about the build.

public:
 void PrecompileApplication(System::Web::Compilation::ClientBuildManagerCallback ^ callback);

public void PrecompileApplication (System.Web.Compilation.ClientBuildManagerCallback callback);

member this.PrecompileApplication : System.Web.Compilation.ClientBuildManagerCallback -> unit

Public Sub PrecompileApplication (callback As ClientBuildManagerCallback)

Parameters

callback

ClientBuildManagerCallback

A ClientBuildManagerCallback containing the method to call when reporting the result of compilation.

Remarks

ASP.NET supports three forms of precompilation. One form allows for the in-place precompilation of an ASP.NET application. In this form, the site is deployed to production and then precompiled, which eliminates the need to dynamically compile the site when it is first visited by a user. The first user of the site will not experience the delay normally encountered on a site that is dynamically compiled. The callback parameter contains the method to call when reporting the result of compilation.

The two other forms of precompilation are used for deployment. In either form, a layout of the site is generated that can be deployed to a production computer. One of these forms includes the markup pages so some amount of updating can be performed on the compiled site. The other form does not contain the markup pages and therefore cannot be updated without recompiling the original site. No source code is deployed to the target environment in either of these forms of precompilation.

The application to precompile is defined through the ClientBuildManager constructor. The ClientBuildManagerParameter object of the ClientBuildManager constructor defines which of the three forms of precompilation to perform.

A developer can precompile a Web site with the aspnet_compiler command-line tool or by calling the PrecompileApplication method.

See also

• ClientBuildManager
• ClientBuildManagerCallback
• ASP.NET Web Site Precompilation

PrecompileApplication(ClientBuildManagerCallback, Boolean)

Precompiles an ASP.NET application, provides a callback method to receive status information about the build, and indicates whether to create a clean build.

public:
 void PrecompileApplication(System::Web::Compilation::ClientBuildManagerCallback ^ callback, bool forceCleanBuild);

public void PrecompileApplication (System.Web.Compilation.ClientBuildManagerCallback callback, bool forceCleanBuild);

member this.PrecompileApplication : System.Web.Compilation.ClientBuildManagerCallback * bool -> unit

Public Sub PrecompileApplication (callback As ClientBuildManagerCallback, forceCleanBuild As Boolean)

Parameters

callback

ClientBuildManagerCallback

A ClientBuildManagerCallback containing the method to call when reporting the result of compilation.

forceCleanBuild

Boolean

true to perform a clean build, which will first delete all object and intermediate files; false to rebuild only those files that have changed. Set to true if there is a chance that a dependency might not be picked up by the build environment.

Remarks

ASP.NET supports three forms of precompilation. One form allows for the in-place precompilation of an ASP.NET application. In this form, the site is deployed to production and then precompiled, which eliminates the need to dynamically compile the site when it is first visited by a user. The first user of the site will not experience the delay normally encountered on a site that is dynamically compiled. The callback parameter contains the method to call when reporting the result of compilation.

The two other forms of precompilation are used for deployment. In either form, a layout of the site is generated that can be deployed to a production computer. One of these forms includes the markup pages so some amount of updating can be performed on the compiled site. The other form does not contain the markup pages and therefore cannot be updated without recompiling the original site. No source code is deployed to the target environment in either of these forms of precompilation.

The application to precompile is defined through the ClientBuildManager constructor. The ClientBuildManagerParameter object of the ClientBuildManager constructor defines which of the three forms of precompilation to perform.

A developer can precompile a Web site with the aspnet_compiler command-line tool or by calling the PrecompileApplication method.

See also

• BuildManager
• BuildProvider
• AssemblyBuilder
• ClientBuildManager
• ClientBuildManagerCallback
• ASP.NET Web Site Precompilation