AppDomain::CreateDomain Method (String)
Creates a new application domain with the specified name.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- friendlyName
- Type: System::String
The friendly name of the domain.
| Exception | Condition |
|---|---|
| ArgumentNullException | friendlyName is nullptr. |
The friendlyName parameter is intended to identify the domain in a manner that is meaningful to humans. This string should be suitable for display in user interfaces.
This method overload uses the AppDomainSetup information from the default application domain.
The following sample demonstrates, in general, how to create a domain using one of the CreateDomain overloads.
// Set up the AppDomainSetup AppDomainSetup^ setup = gcnew AppDomainSetup; setup->ApplicationBase = "(some directory)"; setup->ConfigurationFile = "(some file)"; // Set up the Evidence Evidence^ baseEvidence = AppDomain::CurrentDomain->Evidence; Evidence^ evidence = gcnew Evidence( baseEvidence ); evidence->AddAssembly( "(some assembly)" ); evidence->AddHost( "(some host)" ); // Create the AppDomain AppDomain^ newDomain = AppDomain::CreateDomain( "newDomain", evidence, setup );
- SecurityPermission
for the ability to create and manipulate an application domain. Associated enumeration: SecurityPermissionFlag::ControlAppDomain. Security action: Demand.
- SecurityPermission
to provide evidence. Associated enumeration: SecurityPermissionFlag::ControlEvidence.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.