<disableFusionUpdatesFromADManager> 要素
アプリケーション ドメインの構成設定をランタイム ホストがオーバーライドできるという既定の動作を、無効にするかどうかを指定します。
<disableFusionUpdatesFromADManager enabled="0|1"/>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
enabled |
必須の属性です。 Fusion の設定をオーバーライドする既定の機能を無効にするかどうかを指定します。 |
enabled 属性
値 |
説明 |
|---|---|
0 |
Fusion の設定をオーバーライドする機能を無効にしません。 .NET Framework Version 4 以降では、これが既定の動作です。 |
1 |
Fusion の設定をオーバーライドする機能を無効にします。 これにより、.NET Framework の以前のバージョンの動作に戻ります。 |
子要素
なし。
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。 |
runtime |
アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。 |
解説
.NET Framework Version 4 以降の既定の動作では、AppDomainManager オブジェクトが構成設定をオーバーライドできます。そのためには、AppDomainManager の独自のサブクラスで、AppDomainManager.InitializeNewDomain メソッドの実装に渡された AppDomainSetup オブジェクトの ConfigurationFile プロパティまたは SetConfigurationBytes メソッドを使用します。 既定のアプリケーション ドメインでは、変更された設定によって、アプリケーション構成ファイルで指定された設定がオーバーライドされます。 その他のアプリケーション ドメインでは、AppDomainManager.CreateDomain メソッドまたは AppDomain.CreateDomain メソッドに渡された構成設定がオーバーライドされます。
渡された構成情報を削除するには、新しい構成情報を渡すか、または null (Visual Basic では Nothing) を渡すことができます。
構成情報は、ConfigurationFile プロパティと SetConfigurationBytes メソッドのどちらか一方に渡すようにしてください。 両方に構成情報を渡した場合、SetConfigurationBytes メソッドはアプリケーション構成ファイルの構成情報をオーバーライドするため、ConfigurationFile プロパティに渡した情報は無視されます。 ConfigurationFile プロパティを使用する場合は、SetConfigurationBytes メソッドに null (Visual Basic では Nothing) を渡すことで、AppDomainManager.CreateDomain メソッドまたは AppDomain.CreateDomain メソッドの呼び出しで指定されたすべての構成バイトを削除できます。
構成情報に加えて、AppDomainManager.InitializeNewDomain メソッドの実装に渡される AppDomainSetup オブジェクトの設定も変更できます。変更できる設定には、ApplicationBase、ApplicationName、CachePath、DisallowApplicationBaseProbing、DisallowBindingRedirects、DisallowCodeDownload、DisallowPublisherPolicy、DynamicBase、LoaderOptimization、PrivateBinPath、PrivateBinPathProbe、ShadowCopyDirectories、および ShadowCopyFiles があります。
.gif "メモ") メモ |
|---|
.NET Framework Version 4 Beta では、これらの追加設定はテストされていません。 |
<disableFusionUpdatesFromADManager> 要素を使用する代わりに、レジストリ設定を作成するか環境変数を設定して、既定の動作を無効にすることもできます。 レジストリの場合、HKCU\Software\Microsoft\.NETFramework または HKLM\Software\Microsoft\.NETFramework の下に COMPLUS_disableFusionUpdatesFromADManager という名前の DWORD 値を作成し、その値を 1 に設定します。 コマンド ラインの場合、COMPLUS_disableFusionUpdatesFromADManager 環境変数を 1 に設定します。
使用例
次のコード例は、<disableFusionUpdatesFromADManager> 要素を使用して、Fusion の設定をオーバーライドする機能を無効にする方法を示しています。
<configuration>
<runtime>
<disableFusionUpdatesFromADManager enabled="1" />
</runtime>
</configuration>