ClientBuildManager Class

Reference

Definition

Namespace:: System.Web.Compilation

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides compilation services for ASP.NET applications.

public ref class ClientBuildManager sealed : MarshalByRefObject, IDisposable

public sealed class ClientBuildManager : MarshalByRefObject, IDisposable

type ClientBuildManager = class
    inherit MarshalByRefObject
    interface IDisposable

Public NotInheritable Class ClientBuildManager
Inherits MarshalByRefObject
Implements IDisposable

Inheritance: Object

MarshalByRefObject
ClientBuildManager

Implements: IDisposable

Remarks

The ClientBuildManager class offers methods and properties for compiling ASP.NET Web applications, and retrieving the generated assemblies or generated source code. Instances of the class are established in the client's application domain and provide access to the ASP.NET build system outside of Microsoft Internet Information Services (IIS). The class can be used to develop customized tools for compiling Web applications.

The command-line tool aspnet_compiler uses the ClientBuildManager class.

Constructors

ClientBuildManager(String, String, String, ClientBuildManagerParameter, TypeDescriptionProvider)	Initializes a new instance of the ClientBuildManager class by using the specified virtual directory, source directory, target directory, compilation parameter, and type-description provider.
ClientBuildManager(String, String, String, ClientBuildManagerParameter)	Initializes a new instance of the ClientBuildManager class with the specified target directory and compilation parameter.
ClientBuildManager(String, String, String)	Initializes a new instance of the ClientBuildManager class with the specified target directory.
ClientBuildManager(String, String)	Initializes a new instance of the ClientBuildManager class without a specified target directory or precompilation flags.

Properties

CodeGenDir	Gets the physical path to the directory used for code generation.
IsHostCreated	Gets a value that indicates whether an application domain for compiling ASP.NET Web applications has been created.

Methods

CompileApplicationDependencies()	Compiles application-dependent files, such as files in the App_Code directory, the Global.asax file, resource files, and Web references.
CompileFile(String, ClientBuildManagerCallback)	Compiles the file represented by the virtual path and provides a callback class to receive status information about the build.
CompileFile(String)	Compiles the file represented by the virtual path.
CreateObject(Type, Boolean)	Creates an object in the application domain of the ASP.NET runtime.
CreateObjRef(Type)	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GenerateCode(String, String, IDictionary)	Generates code from the contents of a file.
GenerateCodeCompileUnit(String, String, Type, CompilerParameters, IDictionary)	Returns the contents, codeDOM tree, compiler type, and compiler parameters for a file represented by a virtual path.
GenerateCodeCompileUnit(String, Type, CompilerParameters, IDictionary)	Returns the codeDOM tree, compiler type, and compiler parameters for a file represented by a virtual path.
GetAppDomainShutdownDirectories()	Gets the directories with files that, when changed, cause the application domain to shut down.
GetBrowserDefinitions()	Gets a collection of browser elements.
GetCodeDirectoryInformation(String, Type, CompilerParameters, String)	Gets information about the compiler type, compiler parameters, and the directory in which to store code files generated from non-code files such as .wsdl files.
GetCompiledType(String)	Compiles the file represented by the virtual path and returns its compiled type.
GetCompilerParameters(String, Type, CompilerParameters)	Returns the compiler type and parameters that are used to build a file represented by a virtual path.
GetGeneratedFileVirtualPath(String)	Returns the virtual path of a generated file.
GetGeneratedSourceFile(String)	Gets the physical path to the generated file for a virtual path.
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetLifetimeService()	Obsolete. Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject)
GetTopLevelAssemblyReferences(String)	Returns an array of the assemblies defined in the Bin directory and the `<assembly>` section of the Web configuration file.
GetType()	Gets the Type of the current instance. (Inherited from Object)
GetVirtualCodeDirectories()	Returns the virtual paths to the App_Code directory and its subdirectories in an ASP.NET application.
InitializeLifetimeService()	Gives the application domain an infinite lifetime by preventing a lease from being created.
IsCodeAssembly(String)	Indicates whether an assembly is a code assembly.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject)
PrecompileApplication()	Precompiles an ASP.NET application.
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.
PrecompileApplication(ClientBuildManagerCallback)	Precompiles an ASP.NET application and provides a callback method to receive status information about the build.
ToString()	Returns a string that represents the current object. (Inherited from Object)
Unload()	Unloads the application domain for compiling ASP.NET Web applications.

Events

AppDomainShutdown	Occurs when an application domain is shut down.
AppDomainStarted	Occurs when an application domain is started.
AppDomainUnloaded	Occurs when an application domain is unloaded.

Explicit Interface Implementations

IDisposable.Dispose()

Terminates the current ASP.NET application.

Applies to

Jaa