<supportedRuntime> 項目
指定應用程式所支援的 Common Language Runtime 版本。 所有以 .NET Framework 1.1 (含) 以後版本所建置的應用程式,都應該使用這個項目。
<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>
組態檔
這個項目可以在應用程式組態檔中使用。