指定該應用程式支援的通用語言執行時版本,以及可選的 .NET Framework 版本。
<configuration>
<startup>
<supportedRuntime>
語法
<supportedRuntime version="runtime version" sku="SKU ID"/>
Attributes
| Attribute | Description |
|---|---|
| version | 選擇性屬性。 一個字串值,指定該應用程式所支援的通用語言執行時(CLR)版本。 關於屬性的有效值 version ,請參閱 「執行時版本」值 章節。
便條:透過 .NET Framework 3.5,「執行時版本」的值呈現為 major。輕。建造。 從 .NET Framework 4 開始,只需使用主要與次要版本號(即「v4.0」而非「v4.0.30319」)。 建議使用較短的弦。 |
| 斯庫 | 選擇性屬性。 一個字串值,指定存貨單元(SKU),而存貨單元又指定該應用程式支援的 .NET Framework 版本。 從 .NET Framework 4.0 開始,建議使用 屬性 sku 。 若有,則表示該應用程式所鎖定的 .NET 框架版本。關於屬性的有效值 sku ,請參閱 「SKU ID」值 章節。 |
備註
若 <supportedRuntime> 該元素不存在於應用程式設定檔中,則使用用於建置應用程式的執行時版本。
<supportedRuntime>所有使用執行時版本 1.1 或更新版本的應用程式都應使用此元素。 僅支援執行時版本 1.0 的應用程式必須使用 <requiredRuntime> 元素。
備註
如果你使用 CorBindToRuntimeByCfg 函式來指定設定檔,你必須在所有版本的執行時中使用該 <requiredRuntime> 元素。 當你使用 <supportedRuntime> 時,這個元素會被忽略。
對於支援 .NET Framework 1.1 到 3.5 版本執行環境的應用程式,當支援多個版本時,第一個元素應指定執行環境的最高偏好版本,最後一個元素則應指定最不偏好的版本。 對於支援 .NET Framework 4.0 或更新版本的應用程式,屬性 version 表示 CLR 版本,這是 .NET Framework 4 及更新版本的共通點,屬性 sku 則表示該應用程式所針對的單一 .NET Framework 版本。
如果 <supportedRuntime> 設定檔中包含該 sku 屬性的元素,且已安裝的 .NET Framework 版本低於指定的支援版本,應用程式將無法執行,反而顯示需安裝支援版本的訊息。 否則,應用程式會嘗試在任何已安裝版本上執行,但若與該版本不完全相容,可能會出現意外行為。 (關於 .NET Framework 版本間相容性差異,請參見 .NET Framework 中的應用程式相容性。)因此,我們建議您將此元素納入應用程式設定檔,以便更容易診斷錯誤。 (Visual Studio 在建立新專案時自動產生的設定檔中已經包含該設定檔。)
備註
如果你的應用程式使用舊有的啟用路徑,例如 CorBindToRuntimeEx 函式,且你希望這些路徑能啟用 CLR 第 4 版而非早期版本,或者你的應用程式是用 .NET Framework 4 建置,但依賴以 .NET Framework 早期版本建置的混合模式組合語言, 僅在支援執行環境清單中指定 .NET Framework 4 是不夠的。 此外,在你的設定檔元素<startup>中,你必須將屬性設useLegacyV2RuntimeActivationPolicy為 。true 然而,將此屬性設為 表示 true 所有使用早期版本 .NET Framework 所建構的元件,皆使用 .NET Framework 4 執行,而非原先使用的執行環境。
我們建議你測試應用程式能執行的所有 .NET Framework 版本。
「執行時版本」值
屬性 runtime 指定特定應用程式所需的通用語言執行時(CLR)版本。 所有 .NET Framework v4.x 版本都指定了 v4.0 CLR。 下表列出該屬性執行 時版本 值 version 的有效值。
| .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.1 | 「v4.0」 |
「SKU ID」值
該 sku 屬性使用目標框架名稱(TFM)來表示該應用程式所鎖定並需要執行的 .NET Framework 版本。 下表列出屬性所支援 sku 的有效值,從 .NET Framework 4 開始。
| .NET Framework 版本 |
sku 屬性 |
|---|---|
| 4.0 | ".NETFramework,Version=v4.0” |
| 4.0,客戶檔案 | ".NETFramework,Version=v4.0,Profile=Client” |
| 4.0,平台更新 1 | ".NETFramework,Version=v4.0.1” |
| 4.0,客戶端檔案,更新 1 | ".NETFramework,Version=v4.0.1,Profile=Client” |
| 4.0,平台更新2 | ".NETFramework,Version=v4.0.2” |
| 4.0,客戶端設定檔,更新 2 | ".NETFramework,Version=v4.0.2,Profile=Client” |
| 4.0,平台更新3 | ".NETFramework,Version=v4.0.3” |
| 4.0,客戶資料,更新 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=v4.7.2” |
| 4.8 | ".NETFramework,Version=v4.8” |
| 4.8.1 | ".NETFramework,Version=v4.8.1” |
Example
以下範例說明如何在設定檔中指定支援的執行時版本。 設定檔顯示該應用程式的目標為 .NET Framework 4.7。
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
</startup>
</configuration>
組態檔
此元素可用於應用程式設定檔中。