mscorlib 2.0.0.0 4.0.0.0 System.MarshalByRefObject System.Runtime.InteropServices.ComVisible(true)

Do not use to configure an application domain in ASP.NET. In ASP.NET, configuration must be handled by the host.

Implementing the class enables a hosting application to participate in the creation of new application domains. To replace the default , identify the assembly and type of the replacement in the APPDOMAIN_MANAGER_ASM and APPDOMAIN_MANAGER_TYPE environment variables, or use the <appDomainManagerAssembly> and <appDomainManagerType> elements in your configuration file. The assembly must be fully trusted and be contained in the global assembly cache or the directory of the starting application. The type and assembly names must be fully qualified in the environment variables. For example:

set APPDOMAIN_MANAGER_TYPE=MyNamespace.TestAppDomainManager

set APPDOMAIN_MANAGER_ASM=customappDomainmanager, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f1368f7b12a08d72

If the assembly that contains your subclass of depends on assemblies that are marked with the conditional (APTCA) attribute, you must include those assemblies in the list that you pass to the property of the you use to create application domains. Otherwise, the assemblies that are marked with the conditional APTCA attribute will be disabled.

The is the managed equivalent of the unmanaged host. An object participates in the creation of new application domains in a process and can customize the new before other managed code runs. The can also supply host managers that participate in other aspects of common language runtime execution. For example, an can identify a object that participates in the security decisions of the application domain.

Only assemblies granted FullTrust, such as assemblies in the global assembly cache or identified as in the method can be loaded in the constructor and the method.

This class contains a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see Link Demands and Inheritance Demands.

Provides a managed equivalent of an unmanaged host.

- Constructor
  2.0.0.0
  4.0.0.0

  Only assemblies granted FullTrust, such as assemblies in the global assembly cache or identified as in the method can be loaded in the constructor and the method.

  Initializes a new instance of the class.

- Property
  2.0.0.0
  4.0.0.0
  System.Runtime.Hosting.ApplicationActivator To be added.

  There is a single designated instance of the class in each to which all add-in and manifest-based application activation calls are routed. The for the current can provide its own custom , or an instance of the default is created.

  Gets the application activator that handles the activation of add-ins and manifest-based applications for the domain.

- Method
  2.0.0.0
  4.0.0.0
  System.Boolean ``

  The default implementation of this method returns false.

  This method is called when the method has been called to increase the isolated storage quota. An application that hosts the common language runtime (CLR) can override the method to perform policy decisions based on an object (which inherits ), and can then allow or prevent the increase. For example, a host could prompt the end user to approve or deny the request to increase the quota. The host's implementation of should take into account the possibility of denial-of-service attacks. For example, it should prompt the user only if the method is called from a user-initiated event such as a button click.

  Indicates whether the specified operation is allowed in the application domain.

  true if the host allows the operation specified by to be performed in the application domain; otherwise, false.

  A subclass of that identifies the operation whose security status is requested.
- Method
  2.0.0.0
  4.0.0.0
  System.AppDomain `` `` ``

  The friendly name, specified by the parameter, can be displayed in user interfaces to identify the domain. For more information, see the property.

  The default method calls the protected method to create the . Overrides of this method do not need to call the method but can return an existing domain.

  Returns a new or existing application domain.

  A new or existing application domain.

  The friendly name of the domain. An object that contains evidence mapped through the security policy to establish a top-of-stack permission set. An object that contains application domain initialization information.
- Method
  2.0.0.0
  4.0.0.0
  System.AppDomain `` `` ``

  This protected helper method handles the creation of a new application domain.

  This friendly name, specified by the parameter, can be displayed in user interfaces to identify the domain. For more information, see the property.

  Provides a helper method to create an application domain.

  A newly created application domain.

  The friendly name of the domain. An object that contains evidence mapped through the security policy to establish a top-of-stack permission set. An object that contains application domain initialization information.
- Property
  2.0.0.0
  4.0.0.0
  System.Reflection.Assembly To be added.

  If the application is a manifest-activated application, the entry assembly is determined from the application manifest. If the application is not manifest activated, the entry assembly is the process executable in the default application domain. In other application domains, the entry assembly is the first executable that was executed by the method.

  Gets the entry assembly for an application.

- Property
  2.0.0.0
  4.0.0.0
  System.Threading.HostExecutionContextManager To be added.

  This property allows a host to provide a that can participate in the flow of the execution context across asynchronous calls.

  Gets the host execution context manager that manages the flow of the execution context.

- Property
  2.0.0.0
  4.0.0.0
  System.Security.HostSecurityManager To be added.

  This property allows a host to provide a to participate in the security decisions for the application domain.

  Gets the host security manager that participates in security decisions for the application domain.

- Property
  2.0.0.0
  4.0.0.0
  System.AppDomainManagerInitializationOptions To be added. To be added.

  Gets the initialization flags for custom application domain managers.

- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Do not use this method to initialize an application domain in ASP.NET. In ASP.NET, configuration must be handled by the host. If you use this method to initialize the application domain, the host throws when it attempts to initialize the application domain. The exception message indicates that initialization has already occurred.

  This method is called immediately after the constructor. The default implementation does nothing. A custom implementation can set up internal classes and delegates, set up an interface with the unmanaged host interface, or set up event handlers for the new .

  Also, for add-in activations, a custom implementation could identify the current as the target application domain.

  Beginning with the net_v40_long, you can use this method to sandbox the default application domain at application startup, or to modify the sandbox of a new application domain. To do this, adjust the and properties on the object that is assigned to the property of , before you initialize the application domain.

  Only assemblies granted FullTrust, such as assemblies in the global assembly cache or identified as in the method can be loaded in the constructor and the method.

  Initializes the new application domain.

  An object that contains application domain initialization information.