<supportedRuntime> 項目

指定應用程式所支援的 Common Language Runtime 版本。 所有以 .NET Framework 1.1 (含) 以後版本所建置的應用程式,都應該使用這個項目。

<configuration>

   <startup>

      <supportedRuntime>

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

屬性

屬性

描述

version

選擇性屬性。

字串值,指定這個應用程式所支援的 Common Language Runtime (CLR) 版本。 CLR 的前三個版本是以 "v1.0.3705"、"v1.1.4322" 和 "v2.0.50727" 來指定。 從 .NET Framework 4 版 開始,只需要主要和次要版本號碼 (也就是,"v4.0" 而不是 "v4.0.30319")。 建議使用較短的字串。

注意事項注意事項
.NET Framework 3.0 版和 3.5 版會使用 CLR 的 2.0.50727 版本。

sku

選擇性屬性。

字串值,指定執行應用程式的 SKU。 如需詳細資訊,請參閱.NET Framework Client Profile

備註

如果應用程式組態檔中沒有 <supportedRuntime> 項目,則會使用建置應用程式時所用的執行階段版本。

所有使用執行階段 1.1 (含) 以後版本所建置的應用程式,都應使用 <supportedRuntime> 項目。 建置為只支援 Runtime 1.0 版的應用程式時,必須使用 <requiredRuntime> 項目。

注意事項注意事項

如果您使用 CorBindToRuntimeByCfg 函式指定組態檔,則必須為該執行階段的所有版本使用 <requiredRuntime> 項目。當您使用 CorBindToRuntimeByCfg 時,會忽略 <supportedRuntime> 項目。

當支援多個執行階段版本時,第一個項目應該指定最偏好的執行階段版本,而最後一個項目則指定最不偏好的版本。

注意事項注意事項

如果應用程式使用舊版啟動路徑 (例如 CorBindToRuntimeEx 函式),而您希望這些路徑啟動 CLR 的版本 4 而不是較早的版本,或者應用程式是使用 .NET Framework 4 所建置,但相依於使用舊版 .NET Framework 建置的混合模式組件,則指定支援執行階段清單中的 .NET Framework 4 並不足夠。此外,在組態檔的 <startup>項目 中,您必須將 useLegacyV2RuntimeActivationPolicy 屬性設定為 true。但是,將此屬性設定為 true,即表示以舊版 .NET Framework 建置的所有元件都是使用 .NET Framework 4 執行,而不是用來建置的執行階段。

範例

下列範例顯示如何在組態檔中指定支援的執行階段版本。

<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

組態檔

這個項目可以在應用程式組態檔中使用。

請參閱

參考

啟動設定結構描述

概念

指定要使用哪一個執行階段版本

其他資源

.NET Framework 的組態檔結構描述

同處理序並存執行