AppDomain.CreateDomain Method (String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) (System)

MSDN Library
.NET Development
.NET Framework 3.5
.NET Framework Class Library
System Namespace
AppDomain Class
AppDomain Methods
CreateDomain Method

CreateDomain Method (String)
CreateDomain Method (String, Evidence)
CreateDomain Method (String, Evidence, AppDomainSetup)

CreateDomain Method (String, Evidence, AppDomainSetup, PermissionSet, StrongName[])

CreateDomain Method (String, Evidence, String, String, Boolean)
CreateDomain Method (String, Evidence, String, String, Boolean, AppDomainInitializer, String[])

AppDomain..::.CreateDomain Method (String, Evidence, AppDomainSetup, PermissionSet, array<StrongName>[]()[])
This page is specific to:.NET Framework Version:2.0 3.03.54.0

.NET Framework Class Library

AppDomain..::.CreateDomain Method (String, Evidence, AppDomainSetup, PermissionSet, array<StrongName>[]()[])

Creates a new application domain using the specified name, evidence, application domain setup information, default permission set, and array of fully trusted assemblies.

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

Syntax

C++

JScript

Copy to Clipboard Print

'Usage

Dim friendlyName As String
Dim securityInfo As Evidence
Dim info As AppDomainSetup
Dim grantSet As PermissionSet
Dim fullTrustAssemblies As StrongName()
Dim returnValue As AppDomain

returnValue = AppDomain.CreateDomain(friendlyName, _
    securityInfo, info, grantSet, fullTrustAssemblies)

'Declaration

Public Shared Function CreateDomain ( _
    friendlyName As String, _
    securityInfo As Evidence, _
    info As AppDomainSetup, _
    grantSet As PermissionSet, _
    ParamArray fullTrustAssemblies As StrongName() _
) As AppDomain

Parameters

friendlyName: Type: System..::.String
The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. For more information, see the description of FriendlyName.

securityInfo: Type: System.Security.Policy..::.Evidence
Evidence mapped through the security policy to establish a top-of-stack permission set. Pass nullNothingnullptra null reference (Nothing in Visual Basic) to use the evidence of the current application domain.

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

grantSet: Type: System.Security..::.PermissionSet
A default permission set that is granted to all assemblies loaded into the new application domain that do not have specific grants.

fullTrustAssemblies: Type: array<System.Security.Policy..::.StrongName>[]()[]
An array of strong names representing assemblies to be considered fully trusted in the new application domain.

Return Value

Type: System..::.AppDomain
The newly created application domain.

Exceptions

Exception	Condition
ArgumentNullException	friendlyName is nullNothingnullptra null reference (Nothing in Visual Basic).
InvalidOperationException	The application domain is nullNothingnullptra null reference (Nothing in Visual Basic).

Remarks

If securityInfo is not supplied, the evidence from the current application domain is used.

The information provided for grantSet and fullTrustAssemblies is used to create an ApplicationTrust object for the new application domain.

If the current application domain has an empty Evidence, SecurityException is thrown when creating a new application domain and passing nullNothingnullptra null reference (Nothing in Visual Basic) for securityInfo. An empty Evidence always results in an empty grant set. For example, a default application domain can have an empty Evidence if it is created from unmanaged code.

.NET Framework Security

SecurityPermission
to provide evidence. Associated enumeration: SecurityPermissionFlag..::.ControlEvidence.
SecurityPermission
for the ability to create and manipulate an application domain. Associated enumeration: SecurityPermissionFlag..::.ControlAppDomain. Security action: Demand.

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

AppDomain Class

AppDomain Members

CreateDomain Overload

System Namespace