<startup> 元素

  • 發行項

指定 Common Language Runtime 啟動資訊。

<configuration>
  <startup>

Syntax

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

屬性和元素

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
useLegacyV2RuntimeActivationPolicy 選擇性屬性。

指定是否要啟用 .NET Framework 2.0 執行時間啟用原則，還是要使用 .NET Framework 4 啟用原則。

useLegacyV2RuntimeActivationPolicy 屬性

值 Description
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> 指定應用程式支援的通用語言執行平台版本。

父元素

元素 Description
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。

備註

使用執行階段 1.1 版或更新版本所建置的所有應用程式，都應使用 <supportedRuntime> 元素。 若建置的應用程式只支援執行階段 1.0 版，則必須使用 <requiredRuntime> 元素。

useLegacyV2RuntimeActivationPolicy 屬性

如果您的應用程式使用舊版啟用路徑，例如CorBindToRuntimeEx 函式，而且您想要這些路徑啟動第 4 版 CLR，而不是舊版，或是您的應用程式是使用 .NET Framework 4 建置，但相依于使用舊版 .NET Framework 建置的混合模式元件。 在這些案例中，將屬性設定為 true。

注意

將屬性設為 true 可避免 CLR 1.1 版或 CLR 2.0 版載入同一個處理序中，這可有效地停用內含式並排功能 (請參閱 COM Interop 的並排執行)。

範例

下列範例說明如何在組態檔中指定執行階段版本。

<!-- 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>

另請參閱