<startup> 要素

[アーティクル]
08/09/2011

共通言語ランタイムのスタートアップ情報を指定します。

<startup useLegacyV2RuntimeActivationPolicy="true|false" > 
</startup>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性	説明
useLegacyV2RuntimeActivationPolicy	省略可能な属性です。 .NET Framework Version 2.0 のランタイムのアクティブ化ポリシーを有効にするか、.NET Framework Version 4 のアクティブ化ポリシーを使用するかを指定します。

useLegacyV2RuntimeActivationPolicy

省略可能な属性です。

.NET Framework Version 2.0 のランタイムのアクティブ化ポリシーを有効にするか、.NET Framework Version 4 のアクティブ化ポリシーを使用するかを指定します。

useLegacyV2RuntimeActivationPolicy 属性

値	説明
true	選択されたランタイムで .NET Framework Version 2.0 のランタイムのアクティブ化ポリシーを有効にし、ランタイムの上限を CLR バージョン 2.0 とするのではなく、レガシのランタイムのアクティブ化手法 (CorBindToRuntimeEx 関数など) を、構成ファイルから選択されたランタイムにバインドするようにします。これにより、構成ファイルから CLR バージョン 4 またはそれ以降が選択された場合、それ以前のバージョンの .NET Framework で作成された混合モードアセンブリは、選択された CLR バージョンで読み込まれます。この値を設定すると、CLR バージョン 1.1 または CLR バージョン 2.0 が同じプロセスに読み込まれなくなり、インプロセスの side-by-side 機能は事実上無効になります。
false	.NET Framework 4 およびそれ以降の既定のアクティブ化ポリシーを使用し、レガシのランタイムのアクティブ化手法で CLR バージョン 1.1 または 2.0 をプロセスに読み込むことができるようにします。この値を設定すると、.NET Framework 4 またはそれ以降でビルドされていない限り、混合モードアセンブリは .NET Framework 4 またはそれ以降に読み込まれなくなります。この値が既定値です。

true

選択されたランタイムで .NET Framework Version 2.0 のランタイムのアクティブ化ポリシーを有効にし、ランタイムの上限を CLR バージョン 2.0 とするのではなく、レガシのランタイムのアクティブ化手法 (CorBindToRuntimeEx 関数など) を、構成ファイルから選択されたランタイムにバインドするようにします。これにより、構成ファイルから CLR バージョン 4 またはそれ以降が選択された場合、それ以前のバージョンの .NET Framework で作成された混合モードアセンブリは、選択された CLR バージョンで読み込まれます。この値を設定すると、CLR バージョン 1.1 または CLR バージョン 2.0 が同じプロセスに読み込まれなくなり、インプロセスの side-by-side 機能は事実上無効になります。

false

.NET Framework 4 およびそれ以降の既定のアクティブ化ポリシーを使用し、レガシのランタイムのアクティブ化手法で CLR バージョン 1.1 または 2.0 をプロセスに読み込むことができるようにします。この値を設定すると、.NET Framework 4 またはそれ以降でビルドされていない限り、混合モードアセンブリは .NET Framework 4 またはそれ以降に読み込まれなくなります。この値が既定値です。

子要素

要素	説明
<requiredRuntime>	共通言語ランタイムのバージョン 1.0 だけがアプリケーションでサポートされることを指定します。ランタイムのバージョン 1.1 以降で構築されたアプリケーションでは、<supportedRuntime> 要素を使用する必要があります。
<supportedRuntime>	アプリケーションでサポートされる共通言語ランタイムのバージョンを指定します。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。

解説

ランタイムのバージョン 1.1 以降を使用して構築されたすべてのアプリケーションでは、<supportedRuntime> 要素を使用する必要があります。ランタイムのバージョン 1.0 をサポートするアプリケーションでは、<requiredRuntime> 要素を使用する必要があります。

Microsoft Internet Explorer でホストされるアプリケーションのスタートアップコードは、<startup> 要素とその子要素を無視します。

useLegacyV2RuntimeActivationPolicy 属性

アプリケーションで CorBindToRuntimeEx 関数などのレガシアクティブ化パスが使用されていて、これらのパスで CLR の以前のバージョンではなくバージョン 4 をアクティブ化する場合、または、アプリケーションは .NET Framework 4 でビルドされているが、以前のバージョンの .NET Framework でビルドされた混合モードのアセンブリに対する依存関係がある場合、この属性は便利です。このようなシナリオでは、属性を true に設定します。

メモ
属性を true に設定すると、CLR バージョン 1.1 または CLR バージョン 2.0 が同じプロセスに読み込まれなくなり、インプロセスの side-by-side 機能は事実上無効になります (「COM 相互運用機能の side-by-side 実行」を参照)。

使用例

構成ファイルでランタイムのバージョンを指定する例を示します。

<!-- When used with version 1.0 of the .NET Framework runtime -->
<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>
<!-- When used with version 1.1 (or later) of the runtime -->
<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>