共用方式為


<supportedRuntime> 元素

指定該應用程式支援的通用語言執行時版本,以及可選的 .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>

組態檔

此元素可用於應用程式設定檔中。

另請參閱