AppDomainManager.InitializeNewDomain(AppDomainSetup) 方法

定義

命名空間:

System

組件:

mscorlib.dll

初始化新應用程式定義域。

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

物件，包含應用程式定義域初始化資訊。

屬性

SecurityCriticalAttribute

範例

下列範例顯示自訂應用程式域管理員方法的 InitializeNewDomain 覆寫。 此程式碼範例是提供給 類別之較大範例的 AppDomainManager 一部分。

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 中的應用程式域。 在 ASP.NET 中，主機必須處理設定。 如果您使用這個方法來初始化應用程式域，主機會在嘗試初始化應用程式域時擲回 InvalidOperationException 。 例外狀況訊息表示已發生初始化。

這個方法會在建構函式之後立即呼叫。 預設 InitializeNewDomain 實作不會執行任何動作。 自訂實作可以設定內部類別和委派、使用 Unmanaged 主機介面設定介面，或為新的 AppDomain 設定事件處理常式。

此外，針對增益集啟用，自訂實作可以將目前的 AppDomain 識別為目標應用程式域。

從 .NET Framework 4 開始，您可以使用此方法在應用程式啟動時將預設應用程式域沙箱化，或修改新應用程式域的沙箱。 若要這樣做，請在初始化應用程式域之前，先調整 DefaultGrantSet 指派給 AppDomainSetup.ApplicationTrust 屬性 appDomainInfo 之 物件的 和 FullTrustAssemblies 屬性 ApplicationTrust 。

注意

只有授與 FullTrust 的元件，例如全域組件快取中的元件，或在 方法中 AppDomain.CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) 識別為 fullTrustAssemblies 的元件，可以在建構函式和 InitializeNewDomain 方法中 AppDomainManager 載入。