AppDomainManager.InitializeNewDomain(AppDomainSetup) Methode

Definition

Namespace:

System

Assembly:

mscorlib.dll

Initialisiert die neue Anwendungsdomäne.

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)

Parameter

appDomainInfo

AppDomainSetup

Ein Objekt, das Initialisierungsinformationen für die Anwendungsdomäne enthält.

Attribute

SecurityCriticalAttribute

Beispiele

Das folgende Beispiel zeigt eine Außerkraftsetzung der InitializeNewDomain Methode für einen benutzerdefinierten Anwendungsdomänen-Manager. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die AppDomainManager Klasse bereitgestellt wird.

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

Hinweise

Wichtig

Verwenden Sie diese Methode nicht, um eine Anwendungsdomäne in ASP.NET zu initialisieren. In ASP.NET muss die Konfiguration vom Host behandelt werden. Wenn Sie diese Methode zum Initialisieren der Anwendungsdomäne verwenden, wird der Host ausgelöst InvalidOperationException , wenn versucht wird, die Anwendungsdomäne zu initialisieren. Die Ausnahmemeldung gibt an, dass die Initialisierung bereits aufgetreten ist.

Diese Methode wird unmittelbar nach dem Konstruktor aufgerufen. Die Standardimplementierung InitializeNewDomain führt nichts aus. Eine benutzerdefinierte Implementierung kann interne Klassen und Stellvertretungen einrichten, eine Schnittstelle mit der nicht verwalteten Hostschnittstelle einrichten oder Ereignishandler für die neue AppDomaineinrichten.

Bei Add-In-Aktivierungen kann eine benutzerdefinierte Implementierung auch den aktuellen AppDomain als Zielanwendungsdomäne identifizieren.

Ab dem .NET Framework 4 können Sie diese Methode verwenden, um die Standardanwendungsdomäne beim Start der Anwendung zu sandkastenn oder den Sandkasten einer neuen Anwendungsdomäne zu ändern. Passen Sie dazu die DefaultGrantSet Eigenschaften FullTrustAssemblies des ApplicationTrust Objekts an, das der AppDomainSetup.ApplicationTrust Eigenschaft zugewiesen appDomainInfoist, bevor Sie die Anwendungsdomäne initialisieren.

Hinweis

Nur Assemblys gewährt FullTrust, z. B. Assemblys im globalen Assemblycache oder identifiziert wie fullTrustAssemblies in der AppDomain.CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) Methode können im AppDomainManager Konstruktor und in der InitializeNewDomain Methode geladen werden.