<supportedRuntime>要素<supportedRuntime> Element

アプリケーションでサポートされる共通言語ランタイムのバージョンを指定します。Specifies which versions of the common language runtime the application supports. バージョン 1.1 以降の .NET Framework で構築されたすべてのアプリケーションでは、この要素を使用する必要があります。This element should be used by all applications built with version 1.1 or later of the .NET Framework.

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

構文Syntax

<supportedRuntime version="runtime version" sku="sku id"/>  

属性Attributes

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

このアプリケーションがサポートする共通言語ランタイム (CLR: Common Language Runtime) のバージョンを指定する文字列値。A string value that specifies the version of the common language runtime (CLR) that this application supports. 有効な値について、version属性を参照してください、 「ランタイム バージョン」値セクションです。For valid values of the version attribute, see the "runtime version" values section. 注: 、.NET Framework 3.5 を"ランタイム バージョン"形式の値はメジャー.マイナー.ビルドです。Note: Through the .NET Framework 3.5, the "runtime version" value takes the form major.minor.build. .NET Framework 4.NET Framework 4 以降では、必要となるのはメジャー バージョン番号とマイナー バージョン番号のみです (つまり、"v4.0.30319" ではなく "v4.0")。Beginning with the .NET Framework 4.NET Framework 4, only the major and minor version numbers are required (that is, "v4.0" instead of "v4.0.30319"). 短い文字列を使用することをお勧めします。The shorter string is recommended.
skusku 省略可能な属性です。Optional attribute.

在庫管理単位 (SKU) を指定する文字列の値。SKU はこのアプリケーションがサポートする .NET Framework リリースを指定します。A string value that specifies the stock-keeping unit (SKU), which in turn specifies which .NET Framework release this application supports.

使用、.NET Framework 4.0 以降、sku属性をお勧めします。Starting with the .NET Framework 4.0, the use of the sku attribute is recommended. この属性が指定される場合は、アプリケーションが対象とする .NET Framework のバージョンを示します。When present, it indicates the version of the .NET Framework that the app targets.

Sku 属性の有効な値は、次を参照してください。、 "sku id"値セクションです。For valid values of the sku attribute, see the "sku id" values section.

コメントRemarks

場合、 <supportedRuntime > 要素が、アプリケーション構成ファイルに存在しない、アプリケーションをビルドするために使用するランタイムのバージョンを使用します。If the <supportedRuntime> element is not present in the application configuration file, the version of the runtime used to build the application is used.

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

注意

使用する場合、 CorBindToRuntimeByCfg構成ファイルを指定する関数を使用する必要があります、<requiredRuntime>ランタイムのすべてのバージョンの要素。If you use the CorBindToRuntimeByCfg function to specify the configuration file, you must use the <requiredRuntime> element for all versions of the runtime. <supportedRuntime>を使用するときに、要素は無視されますCorBindToRuntimeByCfgです。The <supportedRuntime> element is ignored when you use CorBindToRuntimeByCfg.

NET Framework 1.1 から 3.5 までのランタイムの複数のバージョンをサポートするアプリケーションでは、ランタイムの複数のバージョンをサポートする場合は、最初の要素で最も優先度の高いバージョンを指定し、最後の要素で最も優先度の低いバージョンを指定する必要があります。For apps that support versions of the runtime from the .NET Framework 1.1 through 3.5, when multiple versions of the runtime are supported, the first element should specify the most preferred version of the runtime, and the last element should specify the least preferred version. .NET Framework 4.0 またはそれ以降のバージョンをサポートするアプリ、version属性は、.NET Framework 4 およびそれ以降のバージョンに共通するが、CLR のバージョンを示します、sku属性が 1 つの .NET Framework のバージョンを示すをアプリターゲット。For apps that support the .NET Framework 4.0 or later versions, the version attribute indicates the CLR version, which is common to the .NET Framework 4 and later versions, and the sku attribute indicates single .NET Framework version that the app targets.

注意

アプリケーションがなど、レガシ アクティブ化のパスを使用するかどうか、 CorBindToRuntimeEx 関数、それらのパスを以前のバージョンではなく CLR の version 4 をアクティブ化して、アプリケーションが、でビルドされた場合または.NET Framework 4.NET Framework 4依存関係を持ちますに、.NET Framework の以前のバージョンでビルドされた混合モード アセンブリには不十分を指定する、.NET Framework 4.NET Framework 4サポートされているランタイムの一覧にします。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.NET Framework 4 but has a dependency on a mixed-mode assembly built with an earlier version of the .NET Framework, it is not sufficient to specify the .NET Framework 4.NET Framework 4 in the list of supported runtimes. さらに、 <スタートアップ > 要素、構成ファイルに設定する必要があります、useLegacyV2RuntimeActivationPolicy属性をtrueです。In addition, in the <startup> element in your configuration file, you must set the useLegacyV2RuntimeActivationPolicy attribute to true. ただし、この属性を true に設定することは、以前のバージョンの .NET Framework でビルドされたすべてのコンポーネントが、それらのビルドに使用されたランタイムではなく、.NET Framework 4.NET Framework 4 を使用して実行されることを意味します。However, setting this attribute to true means that all components built with earlier versions of the .NET Framework are run using the .NET Framework 4.NET Framework 4 instead of the runtimes they were built with.

アプリケーションは、そのアプリケーションを実行できる .NET Framework のすべてのバージョンでテストすることをお勧めします。We recommend that you test applications with all the .NET Framework versions that they can run on.

"ランタイム バージョン" の値"runtime version" values

runtime属性が特定のアプリケーションに必要な共通言語ランタイム (CLR) バージョンを指定します。The runtime attribute specifies the Common Language Runtime (CLR) version that is required for a given application. すべてのバージョンの .NET Framework v4.x 指定、 v4.0 CLR です。Note that all .NET Framework v4.x versions specify the v4.0 CLR. 次の表に、有効な値をランタイム バージョンの値、version属性。The following table lists valid values for the runtime version value of the version attribute.

.NET Framework のバージョン.NET Framework version version 属性version attribute
11.0 "v1.0.3705""v1.0.3705"
1.11.1 "v1.1.4322""v1.1.4322"
2.02.0 "v2.0.50727""v2.0.50727"
3.03.0 "v2.0.50727""v2.0.50727"
3.53.5 "v2.0.50727""v2.0.50727"
4.0 4.7.24.0-4.7.2 "v4.0""v4.0"

"sku id" の値"sku id" values

sku属性では、ターゲット フレームワーク モニカー (TFM) を使用して、アプリをターゲットし、実行に必要とする .NET Framework のバージョンを示します。The sku attribute uses a target framework moniker (TFM) to indicate the version of the .NET Framework that the app targets and requires to run. 次の表に、有効な値でサポートされている、sku属性に、.NET Framework 4 以降でします。The following table lists valid values that are supported by the sku attribute, starting with the .NET Framework 4.

.NET Framework のバージョン.NET Framework version sku 属性sku attribute
4.04.0 ".NETFramework,Version=v4.0"".NETFramework,Version=v4.0"
4.0、Client Profile4.0, Client Profile ".NETFramework,Version=v4.0,Profile=Client"".NETFramework,Version=v4.0,Profile=Client"
4.0、プラットフォームの更新プログラム 14.0, platform update 1 .NETFramework,Version=v4.0.1.NETFramework,Version=v4.0.1
4.0、Client Profile、更新プログラム 14.0, Client Profile, update 1 .NETFramework,Version=v4.0.1,Profile=Client.NETFramework,Version=v4.0.1,Profile=Client
4.0、プラットフォームの更新プログラム 24.0, platform update 2 .NETFramework,Version=v4.0.2.NETFramework,Version=v4.0.2
4.0、Client Profile、更新プログラム 24.0, Client Profile, update 2 .NETFramework,Version=v4.0.2,Profile=Client.NETFramework,Version=v4.0.2,Profile=Client
4.0、プラットフォームの更新プログラム 34.0, platform update 3 .NETFramework,Version=v4.0.3.NETFramework,Version=v4.0.3
4.0、Client Profile、更新プログラム 34.0, Client Profile, update 3 .NETFramework,Version=v4.0.3,Profile=Client.NETFramework,Version=v4.0.3,Profile=Client
4.54.5 ".NETFramework,Version=v4.5"".NETFramework,Version=v4.5"
4.5.14.5.1 ".NETFramework,Version=v4.5.1"".NETFramework,Version=v4.5.1"
4.5.24.5.2 ".NETFramework,Version=v4.5.2"".NETFramework,Version=v4.5.2"
4.64.6 ".NETFramework,Version=v4.6"".NETFramework,Version=v4.6"
4.6.14.6.1 ".NETFramework,Version=v4.6.1"".NETFramework,Version=v4.6.1"
4.6.24.6.2 ".NETFramework,Version=v4.6.2"".NETFramework,Version=v4.6.2"
4.74.7 ".NETFramework,Version=v4.7"".NETFramework,Version=v4.7"
4.7.14.7.1 ".NETFramework,Version=v4.7.1"".NETFramework,Version=v4.7.1"
4.7.24.7.2 ".NETFramework, Version = v4.7.2"".NETFramework,Version=v4.7.2"

Example

サポートされているランタイムのバージョンを構成ファイルで指定する例を次に示します。The following example shows how to specify the supported runtime version in a configuration file. 構成ファイルでは、アプリの対象 .NET Framework 4.7 であることを示します。The configuration file indicates that the app targets the .NET Framework 4.7.

<configuration>  
   <startup>  
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />  
   </startup>  
</configuration>  

構成ファイルConfiguration file

この要素は、アプリケーション構成ファイルで使用できます。This element can be used in the application configuration file.

関連項目See also

スタートアップ設定スキーマStartup Settings Schema
構成ファイル スキーマConfiguration File Schema
インプロセスの side-by-side 実行In-Process Side-by-Side Execution