<startup> 要素<startup> element

共通言語ランタイムのスタートアップの情報を指定します。Specifies common language runtime startup information.

<configuration> <startup><configuration> <startup>

構文Syntax

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

属性と要素Attributes and elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
useLegacyV2RuntimeActivationPolicy 省略可能な属性です。Optional attribute.

.NET Framework 2.0 ランタイムのアクティブ化ポリシーを有効にする、または .NET Framework 4 のアクティブ化ポリシーを使用するかどうかを指定します。Specifies whether to enable the .NET Framework 2.0 runtime activation policy or to use the .NET Framework 4 activation policy.

useLegacyV2RuntimeActivationPolicy 属性useLegacyV2RuntimeActivationPolicy attribute

Value 説明Description
true レガシ ランタイムのアクティブ化の手法をバインドするには、選択したランタイムの .NET Framework 2.0 ランタイムのアクティブ化ポリシーを有効にする (など、 CorBindToRuntimeEx 関数)、ランタイムの代わりに、構成ファイルから選択するにはCLR バージョン 2.0 では、それらを上限します。Enable .NET Framework 2.0 runtime activation policy for the chosen runtime, which is to bind legacy runtime activation techniques (such as the CorBindToRuntimeEx function) to the runtime chosen from the configuration file instead of capping them at CLR version 2.0. したがって、CLR バージョン 4 以降を構成ファイルから選択した場合、.NET Framework の以前のバージョンで作成された混合モードのアセンブリは、選択した CLR バージョンで読み込まれます。Thus, if CLR version 4 or later is chosen from the configuration file, mixed-mode assemblies created with earlier versions of the .NET Framework are loaded with the chosen CLR version. この値の設定も、実質的にインプロセスでサイド バイ サイドでの機能を無効にする、同じプロセスに読み込みの CLR バージョン 1.1 または CLR バージョン 2.0 はできません。Setting this value prevents CLR version 1.1 or CLR version 2.0 from loading into the same process, effectively disabling the in-process side-by-side feature.
false レガシの実行時に CLR 1.1 または 2.0 バージョンを読み込むプロセスのアクティブ化の手法を許可する、.NET Framework 4 以降では、既定のアクティブ化のポリシーを使用します。Use the default activation policy for the .NET Framework 4 and later, which is to allow legacy runtime activation techniques to load CLR version 1.1 or 2.0 into the process. この値を設定すると、混合モードのアセンブリから、またはそれ以降、.NET Framework 4 でビルドされた場合を除きに、.NET Framework 4 またはそれ以降の読み込みができません。Setting this value prevents mixed-mode assemblies from loading into the .NET Framework 4 or later unless they were built with the .NET Framework 4 or later. この値が既定値です。This value is the default.

子要素Child elements

要素Element 説明Description
<requiredRuntime><requiredRuntime> バージョン 1.0 の共通言語ランタイムのみがアプリケーションでサポートされることを指定します。Specifies that the application supports only version 1.0 of the common language runtime. ランタイム バージョン 1.1 以降でビルドされたアプリケーションを使用する必要があります、 <supportedRuntime > 要素。Applications built with runtime version 1.1 or later should use the <supportedRuntime> element.
<supportedRuntime><supportedRuntime> アプリケーションでサポートされる共通言語ランタイムのバージョンを指定します。Specifies which versions of the common language runtime the application supports.

親要素Parent elements

要素Element 説明Description
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。The root element in every configuration file used by the common language runtime and .NET Framework applications.

RemarksRemarks

<SupportedRuntime > 1.1 以降、ランタイムのバージョンを使用して構築されたすべてのアプリケーションで要素を使用する必要があります。The <supportedRuntime> element should be used by all applications built using version 1.1 or later of the runtime. ランタイムのバージョン 1.0 をサポートするために構築されたアプリケーションを使用する必要があります、 <requiredRuntime > 要素。Applications built to support only version 1.0 of the runtime must use the <requiredRuntime> element.

Microsoft Internet Explorer でホストされるアプリケーションのスタートアップ コードは無視されます、 <スタートアップ > 要素とその子要素。The startup code for an application hosted in Microsoft Internet Explorer ignores the <startup> element and its child elements.

UseLegacyV2RuntimeActivationPolicy 属性The useLegacyV2RuntimeActivationPolicy attribute

この属性は、アプリケーションなどに、レガシ アクティブ化パスを使用する場合に便利ですが、 CorBindToRuntimeEx 関数、それらのパスを以前のバージョンではなく、CLR の version 4 をアクティブ化して、アプリケーションがある場合、またはビルドされた .NET Framework 4、.NET Framework の以前のバージョンでビルドされた混合モードのアセンブリに依存しています。This attribute is useful if your application uses legacy activation paths, such as the CorBindToRuntimeEx function, and you want those paths to activate version 4 of the CLR instead of an earlier version, or if your application is built with the .NET Framework 4 but has a dependency on a mixed-mode assembly built with an earlier version of the .NET Framework. そのようなシナリオで、属性を設定してtrueします。In those scenarios, set the attribute to true.

注意

属性を設定trueCLR version 1.1 または CLR バージョン 2.0 が実質的にインプロセスでサイド バイ サイドでの機能を無効にする、同じプロセスに読み込まれなくなります (を参照してくださいCOM 相互運用機能のサイド バイ サイドで実行)。Setting the attribute to true prevents CLR version 1.1 or CLR version 2.0 from loading into the same process, effectively disabling the in-process side-by-side feature (see Side-by-Side Execution for COM Interop).

Example

次の例では、構成ファイルでランタイムのバージョンを指定する方法を示します。The following example shows how to specify the runtime version in a configuration file.

<!-- 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>

関連項目See also