<appDomainManagerAssembly> Element

Specifies the assembly that provides the application domain manager for the default application domain in the process.

<configuration> Element
  <runtime> Element
    <appDomainManagerAssembly> Element

<appDomainManagerAssembly 
   value="assembly display name" />

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

value

Required attribute. Specifies the display name of the assembly that provides the application domain manager for the default application domain in the process.

Child Elements

None.

Parent Elements

Element

Description

configuration

The root element in every configuration file used by the common language runtime and .NET Framework applications.

runtime

Contains information about assembly binding and garbage collection.

Remarks

To specify the type of the application domain manager, you must specify both this element and the <appDomainManagerType> element. If either of these elements is not specified, the other is ignored.

When the default application domain is loaded, TypeLoadException is thrown if the specified assembly does not exist or if the assembly does not contain the type specified by the <appDomainManagerType> element; and the process fails to start. If the assembly is found but the version information does not match, a FileLoadException is thrown.

When you specify the application domain manager type for the default application domain, other application domains created from the default application domain inherit the application domain manager type. Use the AppDomainSetup.AppDomainManagerType and AppDomainSetup.AppDomainManagerAssembly properties to specify a different application domain manager type for a new application domain.

Specifying the application domain manager type requires the application to have full trust. (For example, an application running on the desktop has full trust.) If the application does not have full trust, a TypeLoadException is thrown.

For the format of the assembly display name, see the Assembly.FullName property.

This configuration element is available only in the .NET Framework version 4 and later.

Example

The following example shows how to specify that the application domain manager for the default application domain of a process is the MyMgr type in the AdMgrExample assembly.

<configuration>
   <runtime>
      <appDomainManagerType value="MyMgr" />
      <appDomainManagerAssembly 
         value="AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3" />
   </runtime>
</configuration>

See Also

Reference

<appDomainManagerType> Element

Runtime Settings Schema

ICLRControl::SetAppDomainManagerType Method

AppDomainSetup.AppDomainManagerType

AppDomainSetup.AppDomainManagerAssembly

Other Resources

Configuration File Schema for the .NET Framework