AppDomain.CreateDomain AppDomain.CreateDomain AppDomain.CreateDomain AppDomain.CreateDomain Method

Определение

Создает новый домен приложения.Creates a new application domain.

Перегрузки

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

Создает новый домен приложения с заданным именем с использованием свидетельства, пути к базовой папке приложения, относительного пути поиска и параметра, указывающего, должна ли загружаться теневая копия сборки в домен приложения.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain. Задает метод обратного вызова, вызываемый, когда инициализируется домен приложения, и массив строковых аргументов для передачи методу обратного вызова.Specifies a callback method that is invoked when the application domain is initialized, and an array of string arguments to pass the callback method.

CreateDomain(String, Evidence, String, String, Boolean) CreateDomain(String, Evidence, String, String, Boolean) CreateDomain(String, Evidence, String, String, Boolean) CreateDomain(String, Evidence, String, String, Boolean)

Создает новый домен приложения с заданным именем с использованием свидетельства, пути к базовой папке приложения, относительного пути поиска и параметра, указывающего, должна ли загружаться теневая копия сборки в домен приложения.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain.

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

Создает новый домен приложения с использованием заданного имени, свидетельства, сведений об установке домена приложения, используемого по умолчанию набора разрешений и массива сборок с полным доверием.Creates a new application domain using the specified name, evidence, application domain setup information, default permission set, and array of fully trusted assemblies.

CreateDomain(String, Evidence) CreateDomain(String, Evidence) CreateDomain(String, Evidence) CreateDomain(String, Evidence)

Создает новый домен приложения с заданным именем с помощью предоставленного свидетельства.Creates a new application domain with the given name using the supplied evidence.

CreateDomain(String) CreateDomain(String) CreateDomain(String) CreateDomain(String)

Создает новый домен приложения с заданным именем.Creates a new application domain with the specified name.

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

Создает новый домен приложения с использованием заданного имени, свидетельства и сведений об установке домена приложения.Creates a new application domain using the specified name, evidence, and application domain setup information.

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

Создает новый домен приложения с заданным именем с использованием свидетельства, пути к базовой папке приложения, относительного пути поиска и параметра, указывающего, должна ли загружаться теневая копия сборки в домен приложения.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain. Задает метод обратного вызова, вызываемый, когда инициализируется домен приложения, и массив строковых аргументов для передачи методу обратного вызова.Specifies a callback method that is invoked when the application domain is initialized, and an array of string arguments to pass the callback method.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, System::String ^ appBasePath, System::String ^ appRelativeSearchPath, bool shadowCopyFiles, AppDomainInitializer ^ adInit, cli::array <System::String ^> ^ adInitArgs);
public static AppDomain CreateDomain (string friendlyName, System.Security.Policy.Evidence securityInfo, string appBasePath, string appRelativeSearchPath, bool shadowCopyFiles, AppDomainInitializer adInit, string[] adInitArgs);
static member CreateDomain : string * System.Security.Policy.Evidence * string * string * bool * AppDomainInitializer * string[] -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, appBasePath As String, appRelativeSearchPath As String, shadowCopyFiles As Boolean, adInit As AppDomainInitializer, adInitArgs As String()) As AppDomain

Параметры

friendlyName
String String String String

Понятное имя домена.The friendly name of the domain. Это понятное имя может отображаться в пользовательском интерфейсе для определения домена.This friendly name can be displayed in user interfaces to identify the domain. Для получения дополнительной информации см. FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence Evidence Evidence Evidence

Свидетельство, идентифицирующее код, который выполняется в домене приложения.Evidence that establishes the identity of the code that runs in the application domain. Передайте значение null для использования свидетельства текущего домена приложения.Pass null to use the evidence of the current application domain.

appBasePath
String String String String

Базовый каталог, в котором распознаватель сборок производит поиск.The base directory that the assembly resolver uses to probe for assemblies. Для получения дополнительной информации см. BaseDirectory.For more information, see BaseDirectory.

appRelativeSearchPath
String String String String

Путь, соответствующий базовому каталогу, в котором распознаватель сборок будет производить поиск закрытых сборок.The path relative to the base directory where the assembly resolver should probe for private assemblies. Для получения дополнительной информации см. RelativeSearchPath.For more information, see RelativeSearchPath.

shadowCopyFiles
Boolean Boolean Boolean Boolean

Значение true для загрузки теневой копии сборки в этот домен приложения.true to load a shadow copy of an assembly into the application domain.

adInit
AppDomainInitializer AppDomainInitializer AppDomainInitializer AppDomainInitializer

Делегат AppDomainInitializer, представляющий метод обратного вызова, вызываемый при инициализации нового объекта AppDomain.An AppDomainInitializer delegate that represents a callback method to invoke when the new AppDomain object is initialized.

adInitArgs
String[]

Массив строковых аргументов, передаваемый методу обратного вызова, представленному объектом adInit, когда инициализируется новый объект AppDomain.An array of string arguments to be passed to the callback represented by adInit, when the new AppDomain object is initialized.

Возвраты

Вновь созданный домен приложения.The newly created application domain.

Исключения

Свойство friendlyName имеет значение null.friendlyName is null.

Комментарии

Метод, представленный adInit , выполняется в контексте только что созданного домена приложения.The method represented by adInit is executed in the context of the newly created application domain.

Если securityInfo аргумент не указан, используется свидетельство из текущего домена приложения.If securityInfo is not supplied, the evidence from the current application domain is used.

Дополнительные сведения о теневом копировании см ShadowCopyFiles . в разделе и теневое копирование сборок.For more information about shadow copying, see ShadowCopyFiles and Shadow Copying Assemblies.

Важно!

Не используйте эту перегрузку метода для создания изолированных доменов приложений.Do not use this method overload to create sandboxed application domains. Начиная с .NET Framework 4.NET Framework 4, свидетельство, передаваемое для securityInfo , больше не влияет на набор прав домена приложения.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Используйте перегрузку CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) метода для создания доменов изолированных приложений.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

Безопасность

SecurityPermission
для предоставления свидетельства.to provide evidence. Связанное перечисление: ControlEvidence.Associated enumeration: ControlEvidence.

CreateDomain(String, Evidence, String, String, Boolean) CreateDomain(String, Evidence, String, String, Boolean) CreateDomain(String, Evidence, String, String, Boolean) CreateDomain(String, Evidence, String, String, Boolean)

Создает новый домен приложения с заданным именем с использованием свидетельства, пути к базовой папке приложения, относительного пути поиска и параметра, указывающего, должна ли загружаться теневая копия сборки в домен приложения.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, System::String ^ appBasePath, System::String ^ appRelativeSearchPath, bool shadowCopyFiles);
public static AppDomain CreateDomain (string friendlyName, System.Security.Policy.Evidence securityInfo, string appBasePath, string appRelativeSearchPath, bool shadowCopyFiles);
static member CreateDomain : string * System.Security.Policy.Evidence * string * string * bool -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, appBasePath As String, appRelativeSearchPath As String, shadowCopyFiles As Boolean) As AppDomain

Параметры

friendlyName
String String String String

Понятное имя домена.The friendly name of the domain. Это понятное имя может отображаться в пользовательском интерфейсе для определения домена.This friendly name can be displayed in user interfaces to identify the domain. Для получения дополнительной информации см. FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence Evidence Evidence Evidence

Свидетельство, идентифицирующее код, который выполняется в домене приложения.Evidence that establishes the identity of the code that runs in the application domain. Передайте значение null для использования свидетельства текущего домена приложения.Pass null to use the evidence of the current application domain.

appBasePath
String String String String

Базовый каталог, в котором распознаватель сборок производит поиск.The base directory that the assembly resolver uses to probe for assemblies. Для получения дополнительной информации см. BaseDirectory.For more information, see BaseDirectory.

appRelativeSearchPath
String String String String

Путь, соответствующий базовому каталогу, в котором распознаватель сборок будет производить поиск закрытых сборок.The path relative to the base directory where the assembly resolver should probe for private assemblies. Для получения дополнительной информации см. RelativeSearchPath.For more information, see RelativeSearchPath.

shadowCopyFiles
Boolean Boolean Boolean Boolean

Если true, теневая копия сборки загружается в этот домен приложения.If true, a shadow copy of an assembly is loaded into this application domain.

Возвраты

Вновь созданный домен приложения.The newly created application domain.

Исключения

Примеры

В следующем примере показано, как создать домен, используя одну из CreateDomain перегрузок.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 );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain      
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Комментарии

Если securityInfo аргумент не указан, используется свидетельство из текущего домена приложения.If securityInfo is not supplied, the evidence from the current application domain is used.

Дополнительные сведения о теневом копировании см ShadowCopyFiles . в разделе и теневое копирование сборок.For more information about shadow copying, see ShadowCopyFiles and Shadow Copying Assemblies.

Важно!

Не используйте эту перегрузку метода для создания изолированных доменов приложений.Do not use this method overload to create sandboxed application domains. Начиная с .NET Framework 4.NET Framework 4, свидетельство, передаваемое для securityInfo , больше не влияет на набор прав домена приложения.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Используйте перегрузку CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) метода для создания доменов изолированных приложений.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

Безопасность

SecurityPermission
для предоставления свидетельства.to provide evidence. Связанное перечисление: ControlEvidence.Associated enumeration: ControlEvidence.

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

Создает новый домен приложения с использованием заданного имени, свидетельства, сведений об установке домена приложения, используемого по умолчанию набора разрешений и массива сборок с полным доверием.Creates a new application domain using the specified name, evidence, application domain setup information, default permission set, and array of fully trusted assemblies.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, AppDomainSetup ^ info, System::Security::PermissionSet ^ grantSet, ... cli::array <System::Security::Policy::StrongName ^> ^ fullTrustAssemblies);
public static AppDomain CreateDomain (string friendlyName, System.Security.Policy.Evidence securityInfo, AppDomainSetup info, System.Security.PermissionSet grantSet, params System.Security.Policy.StrongName[] fullTrustAssemblies);
static member CreateDomain : string * System.Security.Policy.Evidence * AppDomainSetup * System.Security.PermissionSet * System.Security.Policy.StrongName[] -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, info As AppDomainSetup, grantSet As PermissionSet, ParamArray fullTrustAssemblies As StrongName()) As AppDomain

Параметры

friendlyName
String String String String

Понятное имя домена.The friendly name of the domain. Это понятное имя может отображаться в пользовательском интерфейсе для определения домена.This friendly name can be displayed in user interfaces to identify the domain. Дополнительные сведения см. в описании FriendlyName.For more information, see the description of FriendlyName.

securityInfo
Evidence Evidence Evidence Evidence

Свидетельство, идентифицирующее код, который выполняется в домене приложения.Evidence that establishes the identity of the code that runs in the application domain. Передайте значение null для использования свидетельства текущего домена приложения.Pass null to use the evidence of the current application domain.

info
AppDomainSetup AppDomainSetup AppDomainSetup AppDomainSetup

Объект, в котором содержатся сведения об инициализации домена приложения.An object that contains application domain initialization information.

grantSet
PermissionSet PermissionSet PermissionSet PermissionSet

Используемый по умолчанию набор разрешений, которые предоставляются всем сборкам, загружаемым в новый домен приложения, не имеющих специальных разрешений.A default permission set that is granted to all assemblies loaded into the new application domain that do not have specific grants.

fullTrustAssemblies
StrongName[]

Массив строгих имен, представляющих сборки, которые будут считаться обладающими полным доверием в новом домене приложения.An array of strong names representing assemblies to be considered fully trusted in the new application domain.

Возвраты

Вновь созданный домен приложения.The newly created application domain.

Исключения

Домен приложения равен null.The application domain is null.

- или --or- Свойство ApplicationBase не задано в объекте AppDomainSetup, который предоставляется для info.The ApplicationBase property is not set on the AppDomainSetup object that is supplied for info.

Комментарии

Необходимо задать ApplicationBase свойство AppDomainSetup объекта, предоставляемого для info.You must set the ApplicationBase property of the AppDomainSetup object that you supply for info. В противном случае создается исключение.Otherwise, an exception is thrown.

Если securityInfo аргумент не указан, используется свидетельство из текущего домена приложения.If securityInfo is not supplied, the evidence from the current application domain is used.

Сведения, предоставленные grantSet для fullTrustAssemblies и ApplicationTrust , используются для создания объекта для нового домена приложения.The information provided for grantSet and fullTrustAssemblies is used to create an ApplicationTrust object for the new application domain.

Безопасность

SecurityPermission
возможность создания домена приложения и управления им.for the ability to create and manipulate an application domain. Связанное перечисление: ControlAppDomain.Associated enumeration: ControlAppDomain. Действие по обеспечению безопасности: Demand.Security action: Demand.

CreateDomain(String, Evidence) CreateDomain(String, Evidence) CreateDomain(String, Evidence) CreateDomain(String, Evidence)

Создает новый домен приложения с заданным именем с помощью предоставленного свидетельства.Creates a new application domain with the given name using the supplied evidence.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo);
public static AppDomain CreateDomain (string friendlyName, System.Security.Policy.Evidence securityInfo);
static member CreateDomain : string * System.Security.Policy.Evidence -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence) As AppDomain

Параметры

friendlyName
String String String String

Понятное имя домена.The friendly name of the domain. Это понятное имя может отображаться в пользовательском интерфейсе для определения домена.This friendly name can be displayed in user interfaces to identify the domain. Для получения дополнительной информации см. FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence Evidence Evidence Evidence

Свидетельство, идентифицирующее код, который выполняется в домене приложения.Evidence that establishes the identity of the code that runs in the application domain. Передайте значение null для использования свидетельства текущего домена приложения.Pass null to use the evidence of the current application domain.

Возвраты

Вновь созданный домен приложения.The newly created application domain.

Исключения

Свойство friendlyName имеет значение null.friendlyName is null.

Примеры

В следующем примере показано, как создать домен, используя одну из CreateDomain перегрузок.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 );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain      
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Комментарии

Эта перегрузка метода использует AppDomainSetup сведения из домена приложения по умолчанию.This method overload uses the AppDomainSetup information from the default application domain.

Если securityInfo аргумент не указан, используется свидетельство из текущего домена приложения.If securityInfo is not supplied, the evidence from the current application domain is used.

Важно!

Не используйте эту перегрузку метода для создания изолированных доменов приложений.Do not use this method overload to create sandboxed application domains. Начиная с .NET Framework 4.NET Framework 4, свидетельство, передаваемое для securityInfo , больше не влияет на набор прав домена приложения.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Используйте перегрузку CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) метода для создания доменов изолированных приложений.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

Безопасность

SecurityPermission
для предоставления свидетельства.to provide evidence. Связанное перечисление: ControlEvidence.Associated enumeration: ControlEvidence.

CreateDomain(String) CreateDomain(String) CreateDomain(String) CreateDomain(String)

Создает новый домен приложения с заданным именем.Creates a new application domain with the specified name.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName);
public static AppDomain CreateDomain (string friendlyName);
static member CreateDomain : string -> AppDomain
Public Shared Function CreateDomain (friendlyName As String) As AppDomain

Параметры

friendlyName
String String String String

Понятное имя домена.The friendly name of the domain.

Возвраты

Вновь созданный домен приложения.The newly created application domain.

Исключения

Свойство friendlyName имеет значение null.friendlyName is null.

Метод не поддерживается в .NET Core.Method not supported on .NET Core.

Примеры

В следующем примере показано, как создать домен, используя одну из CreateDomain перегрузок.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 );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain      
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Комментарии

friendlyName Параметр предназначен для однозначного обнаружения домена, который имеет смысл для человека.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.

Эта перегрузка метода использует AppDomainSetup сведения из домена приложения по умолчанию.This method overload uses the AppDomainSetup information from the default application domain.

Безопасность

SecurityPermission
для предоставления свидетельства.to provide evidence. Связанное перечисление: ControlEvidence.Associated enumeration: ControlEvidence.

Дополнительно

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

Создает новый домен приложения с использованием заданного имени, свидетельства и сведений об установке домена приложения.Creates a new application domain using the specified name, evidence, and application domain setup information.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, AppDomainSetup ^ info);
public static AppDomain CreateDomain (string friendlyName, System.Security.Policy.Evidence securityInfo, AppDomainSetup info);
static member CreateDomain : string * System.Security.Policy.Evidence * AppDomainSetup -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, info As AppDomainSetup) As AppDomain

Параметры

friendlyName
String String String String

Понятное имя домена.The friendly name of the domain. Это понятное имя может отображаться в пользовательском интерфейсе для определения домена.This friendly name can be displayed in user interfaces to identify the domain. Для получения дополнительной информации см. FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence Evidence Evidence Evidence

Свидетельство, идентифицирующее код, который выполняется в домене приложения.Evidence that establishes the identity of the code that runs in the application domain. Передайте значение null для использования свидетельства текущего домена приложения.Pass null to use the evidence of the current application domain.

info
AppDomainSetup AppDomainSetup AppDomainSetup AppDomainSetup

Объект, в котором содержатся сведения об инициализации домена приложения.An object that contains application domain initialization information.

Возвраты

Вновь созданный домен приложения.The newly created application domain.

Исключения

Примеры

В следующем примере показано, как создать домен, используя одну из CreateDomain перегрузок.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 );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain      
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Комментарии

Если info не указан, эта перегрузка метода AppDomainSetup использует сведения из домена приложения по умолчанию.If info is not supplied, this method overload uses the AppDomainSetup information from the default application domain.

Если securityInfo аргумент не указан, используется свидетельство из текущего домена приложения.If securityInfo is not supplied, the evidence from the current application domain is used.

Важно!

Не используйте эту перегрузку метода для создания изолированных доменов приложений.Do not use this method overload to create sandboxed application domains. Начиная с .NET Framework 4.NET Framework 4, свидетельство, передаваемое для securityInfo , больше не влияет на набор прав домена приложения.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Используйте перегрузку CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) метода для создания доменов изолированных приложений.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

Безопасность

SecurityPermission
для предоставления свидетельства.to provide evidence. Связанное перечисление: ControlEvidence.Associated enumeration: ControlEvidence.

Применяется к