AppDomain..::.CreateDomain Method (String, Evidence, AppDomainSetup, PermissionSet, array<StrongName>[]()[]) Home
This page is specific to:.NET Framework Version:2.03.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

'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

ExceptionCondition
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

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
See Also

Reference

© 2009 Microsoft Corporation. All rights reserved.   Terms of Use | Trademarks | Privacy Statement
Page view tracker
Rate the Lightweight library
x
Lightweight builds on ScriptFree (loband) by adding features you've requested: a SearchBox and default code language selection.
Do you like the SearchBox?
Do you like the tabbed code blocks?
How useful is this topic?
Tell us more.
Thanks
x
You're helping to improve MSDN Online.
Feedback
Switch View
Classic
Lightweight Beta
ScriptFree
Switch View