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 の実装では何も行われません。 カスタム実装では、内部クラスとデリゲートを設定したり、アンマネージ ホスト インターフェイスを使用してインターフェイスを設定したり、新しい AppDomainイベント ハンドラーを設定したりできます。

また、アドインのアクティブ化では、カスタム実装によって現在 AppDomain のアプリケーション ドメインがターゲット アプリケーション ドメインとして識別される場合があります。

.NET Framework 4 以降では、このメソッドを使用して、アプリケーションの起動時に既定のアプリケーション ドメインをサンドボックス化したり、新しいアプリケーション ドメインのサンドボックスを変更することができます。 これを行うには、アプリケーション ドメインをDefaultGrantSet初期化するApplicationTrust前に、プロパティにAppDomainSetup.ApplicationTrust割り当てられているオブジェクトのappDomainInfoプロパティとFullTrustAssembliesプロパティを調整します。

注意

許可されたFullTrustアセンブリ (グローバル アセンブリ キャッシュ内のアセンブリなど)、またはメソッド内でAppDomain.CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])識別されたfullTrustAssembliesアセンブリのみをコンストラクターとメソッドにAppDomainManagerInitializeNewDomain読み込むことができます。