AppDomainManager.InitializeNewDomain(AppDomainSetup) Method

Definition

Initialisiert die neue Anwendungsdomäne.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
Public Overridable Sub InitializeNewDomain (appDomainInfo As AppDomainSetup)

Parameters

appDomainInfo
AppDomainSetup

Ein Objekt, das Initialisierungsinformationen für die Anwendungsdomäne enthält.An object that contains application domain initialization information.

Attributes

Examples

Das folgende Beispiel zeigt eine außer Kraft setzung der InitializeNewDomain-Methode für einen benutzerdefinierten Anwendungs Domänen-Manager.The following example shows an override of the InitializeNewDomain method for a custom application domain manager. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die AppDomainManager-Klasse bereitgestellt wird.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

Remarks

Important

Verwenden Sie diese Methode nicht, um eine Anwendungsdomäne in ASP.net zu initialisieren.Do not use this method to initialize an application domain in ASP.NET. In ASP.NET muss die Konfiguration vom Host verarbeitet werden.In ASP.NET, configuration must be handled by the host. Wenn Sie diese Methode zum Initialisieren der Anwendungsdomäne verwenden, löst der Host InvalidOperationException aus, wenn er versucht, die Anwendungsdomäne zu initialisieren.If you use this method to initialize the application domain, the host throws InvalidOperationException when it attempts to initialize the application domain. Die Ausnahme Meldung gibt an, dass bereits eine Initialisierung aufgetreten ist.The exception message indicates that initialization has already occurred.

Diese Methode wird unmittelbar nach dem-Konstruktor aufgerufen.This method is called immediately after the constructor. Der Standard InitializeNewDomain-Implementierung führt keine Aktion aus.The default InitializeNewDomain implementation does nothing. Eine benutzerdefinierte Implementierung kann interne Klassen und Delegaten einrichten, eine Schnittstelle mit der nicht verwalteten Host Schnittstelle einrichten oder Ereignishandler für die neue AppDomaineinrichten.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.

Außerdem könnte eine benutzerdefinierte Implementierung für Add-in-Aktivierungen die aktuelle AppDomain als Ziel Anwendungsdomäne identifizieren.Also, for add-in activations, a custom implementation could identify the current AppDomain as the target application domain.

Beginnend mit dem .NET Framework 4.NET Framework 4können Sie diese Methode verwenden, um die Standard Anwendungsdomäne beim Anwendungsstart zu übernehmen oder um die Sandbox einer neuen Anwendungsdomäne zu ändern.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. Passen Sie dazu die Eigenschaften DefaultGrantSet und FullTrustAssemblies für das ApplicationTrust-Objekt an, das der Eigenschaft AppDomainSetup.ApplicationTrust von appDomainInfozugewiesen ist, bevor Sie die Anwendungsdomäne initialisieren.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.

Note

Nur Assemblys, die FullTrustgewährt wurden, z. b. Assemblys im globalen Assemblycache oder als fullTrustAssemblies in der AppDomain.CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])-Methode identifiziert, können im AppDomainManager-Konstruktor und in der InitializeNewDomain-MethodeOnly 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.

Applies to