AppDomainManager.InitializeNewDomain(AppDomainSetup) Метод

Определение

Инициализирует новый домен приложения.Initializes the new application domain.

public:
 virtual void InitializeNewDomain(AppDomainSetup ^ appDomainInfo);
public virtual void InitializeNewDomain (AppDomainSetup appDomainInfo);
[System.Security.SecurityCritical]
public virtual void InitializeNewDomain (AppDomainSetup appDomainInfo);
abstract member InitializeNewDomain : AppDomainSetup -> unit
override this.InitializeNewDomain : AppDomainSetup -> unit
[<System.Security.SecurityCritical>]
abstract member InitializeNewDomain : AppDomainSetup -> unit
override this.InitializeNewDomain : AppDomainSetup -> unit
Public Overridable Sub InitializeNewDomain (appDomainInfo As AppDomainSetup)

Параметры

appDomainInfo
AppDomainSetup

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

Атрибуты

Примеры

В следующем примере показано переопределение InitializeNewDomain метода для пользовательского диспетчера домена приложения.The following example shows an override of the InitializeNewDomain method for a custom application domain manager. Этот пример кода является частью большого примера, приведенного для AppDomainManager класса.This code example is part of a larger example provided for the AppDomainManager class.

public override void InitializeNewDomain(AppDomainSetup appDomainInfo)
{
    Console.Write("Initialize new domain called:  ");
    Console.WriteLine(AppDomain.CurrentDomain.FriendlyName);
    InitializationFlags =
        AppDomainManagerInitializationOptions.RegisterWithHost;
}
Public Overrides Sub InitializeNewDomain(ByVal appDomainInfo _
    As AppDomainSetup) 
    Console.Write("Initialize new domain called:  ")
    Console.WriteLine(AppDomain.CurrentDomain.FriendlyName)
    InitializationFlags = _
        AppDomainManagerInitializationOptions.RegisterWithHost   
End Sub

Комментарии

Важно!

Не используйте этот метод для инициализации домена приложения в ASP.NET.Do not use this method to initialize an application domain in ASP.NET. В ASP.NET конфигурация должна обрабатываться узлом.In ASP.NET, configuration must be handled by the host. При использовании этого метода для инициализации домена приложения узел вызывается InvalidOperationException при попытке инициализировать домен приложения.If you use this method to initialize the application domain, the host throws InvalidOperationException when it attempts to initialize the application domain. Сообщение об исключении указывает на то, что инициализация уже выполнена.The exception message indicates that initialization has already occurred.

Этот метод вызывается сразу после конструктора.This method is called immediately after the constructor. Реализация по умолчанию InitializeNewDomain не выполняет никаких действий.The default InitializeNewDomain implementation does nothing. Пользовательская реализация может настроить внутренние классы и делегаты, настроить интерфейс с неуправляемым интерфейсом узла или настроить обработчики событий для нового AppDomain .A custom implementation can set up internal classes and delegates, set up an interface with the unmanaged host interface, or set up event handlers for the new AppDomain.

Кроме того, при активации надстройки пользовательская реализация может указать текущий в AppDomain качестве целевого домена приложения.Also, for add-in activations, a custom implementation could identify the current AppDomain as the target application domain.

Начиная с .NET Framework 4.NET Framework 4 , этот метод можно использовать для песочницы домена приложения по умолчанию при запуске приложения или для изменения "песочницы" нового домена приложения.Beginning with the .NET Framework 4.NET Framework 4, you can use this method to sandbox the default application domain at application startup, or to modify the sandbox of a new application domain. Для этого измените DefaultGrantSet FullTrustAssemblies Свойства и для ApplicationTrust объекта, присвоенного AppDomainSetup.ApplicationTrust свойству appDomainInfo , перед инициализацией домена приложения.To do this, adjust the DefaultGrantSet and FullTrustAssemblies properties on the ApplicationTrust object that is assigned to the AppDomainSetup.ApplicationTrust property of appDomainInfo, before you initialize the application domain.

Примечание

Только предоставленные сборки FullTrust , такие как сборки в глобальном кэше сборок или определенные как fullTrustAssemblies в AppDomain.CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) методе, можно загрузить в AppDomainManager конструктор и InitializeNewDomain метод.Only assemblies granted FullTrust, such as assemblies in the global assembly cache or identified as fullTrustAssemblies in the AppDomain.CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method can be loaded in the AppDomainManager constructor and the InitializeNewDomain method.

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