AppDomainManager.CreateDomain Method (System)

.NET Framework Class Library

AppDomainManager..::.CreateDomain Method

Returns an application domain that can be either a new or existing domain.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

Public Overridable Function CreateDomain ( _
    friendlyName As String, _
    securityInfo As Evidence, _
    appDomainInfo As AppDomainSetup _
) As AppDomain

Visual Basic (Usage)

Dim instance As AppDomainManager
Dim friendlyName As String
Dim securityInfo As Evidence
Dim appDomainInfo As AppDomainSetup
Dim returnValue As AppDomain

returnValue = instance.CreateDomain(friendlyName, _
    securityInfo, appDomainInfo)

public virtual AppDomain CreateDomain(
    string friendlyName,
    Evidence securityInfo,
    AppDomainSetup appDomainInfo
)

Visual C++

public:
virtual AppDomain^ CreateDomain(
    String^ friendlyName, 
    Evidence^ securityInfo, 
    AppDomainSetup^ appDomainInfo
)

JScript

public function CreateDomain(
    friendlyName : String, 
    securityInfo : Evidence, 
    appDomainInfo : AppDomainSetup
) : AppDomain

Parameters

friendlyName: Type: System..::.String
The friendly name of the domain.

securityInfo: Type: System.Security.Policy..::.Evidence
An Evidence object that contains evidence mapped through the security policy to establish a top-of-stack permission set.

appDomainInfo: Type: System..::.AppDomainSetup
An AppDomainSetup object that contains application domain initialization information.

Return Value

Type: System..::.AppDomain
An AppDomain object.

Remarks

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

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

Notes to Inheritors:

When you inherit from the AppDomainManager class and override the CreateDomain method, you can perform custom application domain initialization activities before calling the CreateDomainHelper method, or not call the helper method at all. For example, you could modify the evidence passed in as securityInfo, update the fields of the associated AppDomainSetup, or reuse an exiting domain.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

AppDomainManager Class

AppDomainManager Members

System Namespace