<requiredRuntime> 項目

指定應用程式只支援 Common Language Runtime 1.0 版。

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

屬性和項目

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

屬性	描述
version	選擇性屬性。字串值，指定這個應用程式所支援的 .NET Framework 版本。字串值必須符合 .NET Framework 安裝根目錄下存在的目錄名稱。不會剖析字串值的內容。
safemode	選擇性屬性。指定 Runtime 啟始程式碼 (Startup Code) 是否搜尋登錄以決定 Runtime 版本。

version

選擇性屬性。

字串值，指定這個應用程式所支援的 .NET Framework 版本。字串值必須符合 .NET Framework 安裝根目錄下存在的目錄名稱。不會剖析字串值的內容。

safemode

選擇性屬性。

指定 Runtime 啟始程式碼 (Startup Code) 是否搜尋登錄以決定 Runtime 版本。

值	描述
false	執行階段啟始程式碼會在登錄中查詢。此為預設值。
true	執行階段啟始程式碼不會在登錄中查詢。

無。

項目	描述
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
startup	包含 <requiredRuntime> 項目。

建置為只支援 Runtime 1.0 版的應用程式時，必須使用 <requiredRuntime> 項目。使用 Runtime 1.1 (含) 以後版本建置的應用程式必須使用 <supportedRuntime> 項目。

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

version 屬性字串必須符合指定的 .NET Framework 版本的安裝資料夾名稱。這個字串並不會被解譯。如果 Runtime 啟始程式碼沒有找到相符的資料夾，則不會載入 Runtime；啟始程式碼會顯示錯誤訊息，並且結束。

注意事項
裝載在 Microsoft Internet Explorer 中的應用程式啟始程式碼會忽略 <requiredRuntime> 項目。

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

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