その他 - アプリケーション構成ファイルのソースを表示

== 概要 ==
スタートアップ設定は、アプリケーションを実行する必要のある共通言語ランタイム(以下、CLRとする)のバージョンを指定する。<br>
<center>
{| class="wikitable"
|-
! 要素 !! 説明
|-
| <requiredRuntime> || .Net Framework1.0の共通言語ランタイムのみがアプリケーションでサポートされることを指定する。<br>.Net Framework1.1でビルドされたアプリケーションは、<supportedRuntime>要素を使用する。
|-
| <supportedRuntime> || アプリケーションでサポートされる共通言語ランタイムのバージョンを指定する。
|-
| <startup> || <requiredRuntime>要素と<supportedRuntime>要素を含む。
|}
</center>
<br><br>

== <supportedRuntime>要素 ==
アプリケーションがサポートするCLRのバージョンとオプションで.NET Frameworkのバージョンを指定する。<br>
<br>
===== 構文 =====
 <supportedRuntime version="runtime version" sku="sku id"/>
* version
*: 省略可能な属性である。
*: このアプリケーションがサポートするCLRのバージョンを指定する文字列である。
*: version属性の有効な値については、version属性の値に関するセクションを参照してください。
*: <br>
*: '''注意 :'''
*: .NET Framework3.5では、versionの値はmajorという形式になる。
*: .NET Framework4以降では、メジャーバージョン番号とマイナーバージョン番号("v v4.0.30319"の代わりに"v4.0")のみが必要である。
*: 短い文字列を使用することを推奨する。
<br>
* sku
*: 省略可能な属性である。
*: 在庫管理単位(SKU)を指定する文字列である。SKUはこのアプリケーションがサポートする.NET Frameworkのリリースを指定する。
*: .NET Framework4.0以降では、sku属性の使用が推奨される。
*: この属性を指定する場合は、アプリケーションが対象とする.NET Frameworkのバージョンを示す。
*: <br>
*: sku属性の有効な値については、下記に示すsku属性の値に関するセクションを参照すること。
<br>
===== version属性の値 =====
version属性は、アプリケーションに必要なCLRのバージョンを指定する。<br>
全ての.NET Framework v4.xバージョンでv4.0が指定されていることに注意すること。<br>
<br>
次の表に、version属性の有効な値を記載する。<br>
<center>
{| class="wikitable"
|-
! .NET Frameworkのバージョン !! version属性
|-
| 1.0 || "v1.0.3705"
|-
| 1.1 || "v1.1.4322"
|-
| 2.0 || "v2.0.50727"
|-
| 3.0 || "v2.0.50727"
|-
| 3.5 || "v2.0.50727"
|-
| 4.0 - 4.8 || "v4.0"
|}
</center>
<br>
===== sku属性の値 =====
sku属性は、ターゲットフレームワークモニカー(TFM)を使用して、アプリが対象として実行する必要がある.NET Framework のバージョンを示す。<br>
'''※この設定は、.NET Framework4以降の場合のみ指定する。'''<br>
<br>
下表に、sku属性でサポートされている有効な値を記載する。<br>
<center>
{| class="wikitable"
|-
! .NET Frameworkのバージョン !! sku属性
|-
| 4.0 || ".NETFramework,Version=v4.0"
|-
| 4.0 Client Profile || ".NETFramework,Version=v4.0,Profile=Client"
|-
| 4.0 プラットフォームの更新プログラム 1 || ".NETFramework、Version = v 4.0.1"
|-
| 4.0 Client Profile、更新プログラム 1 || ".NETFramework,Version=v4.0.1,Profile=Client"
|-
| 4.0 プラットフォームの更新プログラム 2 || ".NETFramework、Version = v 4.0.2"
|-
| 4.0 Client Profile、更新プログラム 2 || ".NETFramework,Version=v4.0.2,Profile=Client"
|-
| 4.0 プラットフォームの更新プログラム 3 || ".NETFramework,Version=v4.0.3"
|-
| 4.0 Client Profile、更新プログラム 3 || ".NETFramework,Version=v4.0.3,Profile=Client"
|-
| 4.5 || ".NETFramework,Version=v4.5"
|-
| 4.5.1 || ".NETFramework,Version=v4.5.1"
|-
| 4.5.2 || ".NETFramework,Version=v4.5.2"
|-
| 4.6 || ".NETFramework,Version=v4.6"
|-
| 4.6.1 || ".NETFramework,Version=v4.6.1"
|-
| 4.6.2 || ".NETFramework,Version=v4.6.2"
|-
| 4.7 || ".NETFramework,Version=v4.7"
|-
| 4.7.1 || ".NETFramework,Version=v4.7.1"
|-
| 4.7.2 || ".NETFramework、Version = v 4.7.2"
|-
| 4.8 || ".NETFramework,Version=v4.8"
|}
</center>
<br>
===== アプリケーション構成ファイルの例 =====
サポートされているCLRのバージョンを、構成ファイルで指定する例を示す。<br>
ここでは、アプリケーション構成ファイルは、アプリケーションが.NET Framework4.7を対象としているものとする。<br>
 <configuration>
    <startup>
       <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
    </startup>
 </configuration>
<br><br>

== 備考 ==
<supportedRuntime>要素がアプリケーション構成ファイルに存在しない場合は、<br>
アプリケーションのビルドに使用した.Net Frameworkのバージョンが使用される。<br>
(Visual Studio等でビルド時に指定した.Net Frameworkのバージョンのこと)<br>
<br>
<supportedruntime>要素は、.Net Framework1.1以降を使用してビルドした全てのアプリケーションで使用する必要がある。<br>
ただし、.Net Framework1.0のみをサポートするようにビルドしたアプリケーションでは、<requiredRuntime>要素を使用する必要がある。<br>
<br><br>

== 注意事項 ==
アプリケーション構成ファイルにsku属性を持つ<supportedRuntime>要素が存在する時、<br>
インストールされている.NET Frameworkのバージョンが古い場合は、<br>
アプリケーションの実行は失敗し、代わりにサポートされる.Net Frameworkのバージョンのインストールを求めるメッセージが表示される。<br>
<br>
それ以外の場合は、インストールされている任意のバージョンでアプリケーションを実行しようとするが、<br>
そのバージョンと完全に互換性がないと、予期しない動作をする可能性がある。<br>
.NET Frameworkのバージョン間の互換性の違いについては、.NET Frameworkの[https://docs.microsoft.com/dotnet/framework/migration-guide/application-compatibility アプリケーションの互換性]を参照すること。<br>
<br><br>

__FORCETOC__
[[カテゴリ:C_Sharp]]