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

RemarksRemarks

場合、 <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 属性は、アプリケーションが対象とする単一の .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. さらに、 <startup > 要素、構成ファイルで設定する必要があります、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、バージョン = v4.0.1"".NETFramework,Version=v4.0.1"
4.0、Client Profile、更新プログラム 14.0, Client Profile, update 1 ".NETFramework、バージョン v4.0.1、プロファイルの = = クライアント"".NETFramework,Version=v4.0.1,Profile=Client"
4.0、プラットフォームの更新プログラム 24.0, platform update 2 ".NETFramework、バージョン = v4.0.2 以降を予定"".NETFramework,Version=v4.0.2"
4.0、Client Profile、更新プログラム 24.0, Client Profile, update 2 ".NETFramework、バージョン = v4.0.2 以降を予定プロファイル、クライアントを ="".NETFramework,Version=v4.0.2,Profile=Client"
4.0、プラットフォームの更新プログラム 34.0, platform update 3 ".NETFramework、バージョン = v4.0.3"".NETFramework,Version=v4.0.3"
4.0、Client Profile、更新プログラム 34.0, Client Profile, update 3 ".NETFramework、バージョン v4.0.3、プロファイルの = = クライアント"".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、バージョン = 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