<startup> 項目

指定 Common Language Runtime 啟動資訊。

<startup useLegacyV2RuntimeActivationPolicy="true|false" > 
</startup>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

屬性

描述

useLegacyV2RuntimeActivationPolicy

選擇性屬性。

指定應啟用 .NET Framework 2.0 版 執行階段啟動原則,或是使用 .NET Framework 4 版 啟動原則。

useLegacyV2RuntimeActivationPolicy 屬性

描述

true

啟用所選執行階段的 .NET Framework 2.0 版 執行階段啟動原則,目的是要將舊版執行階段啟動技術 (例如 CorBindToRuntimeEx 函式) 繫結至選擇自組態檔案的執行階段,而不是將其蓋在 CLR 2.0 版本之上。 因此,如果從組態檔案中選擇 CLR 版本 4 (含) 以後版本,就會使用與所選 CLR 版本一起載入的舊版 .NET Framework 來建立混合模式組件。 設定此值可避免 CLR 1.1 版或 CLR 2.0 版載入至相同的處理序,並有效停用同處理序並存功能。

false

使用 .NET Framework 4 (含) 以後版本的預設啟動原則,目的是要讓舊版執行階段啟動技術將 CLR 版本 1.1 或 2.0 載入至處理序中。 設定此值可防止混合模式組件載入至 .NET Framework 4 (含) 以後版本,除非這些組件是以 .NET Framework 4 (含) 以後版本所建置。這是預設值。

子項目

項目

描述

<requiredRuntime>

指定應用程式只支援 Common Language Runtime 1.0 版。 以執行階段版本 1.1 (含) 以後版本建置的應用程式,應該要使用 <supportedRuntime> 項目。

<supportedRuntime>

指定應用程式所支援的 Common Language Runtime 版本。

父項目

項目

描述

configuration

Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。

備註

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

裝載在 Microsoft Internet Explorer 中的應用程式啟始程式碼會忽略 <startup> 項目和其子項目。

useLegacyV2RuntimeActivationPolicy 屬性

如果應用程式使用舊版啟動路徑 (例如 CorBindToRuntimeEx 函式),而您希望這些路徑啟動 CLR 的版本 4 而不是較早的版本,或者應用程式是使用 .NET Framework 4 所建置,但相依於使用舊版 .NET Framework 建置的混合模式組件,這個屬性就很有用。 在這些情節中,請將屬性設定為 true。

注意事項注意事項

將屬性設定為 true 可避免 CLR 1.1 版或 CLR 2.0 版載入至相同的處理序,並有效停用同處理序並存功能 (請參閱COM Interop 的並存執行)。

範例

下列範例顯示如何在組態檔中指定 Runtime 版本。

<!-- When used with version 1.0 of the .NET Framework runtime -->
<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>
<!-- When used with version 1.1 (or later) of the runtime -->
<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

請參閱

參考

啟動設定結構描述

概念

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

其他資源

.NET Framework 的組態檔結構描述

COM Interop 的並存執行

同處理序並存執行