<requiredRuntime> 元素

指定應用程式只支援 Common Language Runtime 1.0 版。 此元素已被取代,不應再使用。 應該改用 supportedRuntime 元素。

<設定>
  <啟動>
    <requiredRuntime>

Syntax

   <requiredRuntime  
version="runtime version"
safemode="true|false"/>

屬性和元素

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

屬性

屬性 描述
version 選擇性屬性。

字串值,指定這個應用程式支援的.NET Framework版本。 字串值必須符合.NET Framework安裝根目錄下找到的目錄名稱。 字串值的內容不會被剖析。
safemode 選擇性屬性。

指定執行階段啟動程式碼是否搜尋登錄以判斷執行階段版本。

safemode 屬性

描述
false 執行階段啟動程式碼會在登錄中查看。 這是預設值。
true 執行階段啟動程式碼不會在登錄中查看。

子元素

無。

父元素

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

備註

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

注意

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

屬性 version 字串必須符合指定版本.NET Framework的安裝資料夾名稱。 不會解譯此字串。 如果執行階段啟動程式碼找不到相符的資料夾,則不會載入;啟動程式碼會顯示錯誤訊息並結束。

範例

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

<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>

另請參閱