<requiredRuntime> 要素

  • [アーティクル]

バージョン 1.0 の共通言語ランタイムのみがアプリケーションでサポートされることを指定します。 この要素は非推奨です。今後は使用しないでください。 代わりに、supportedRuntime 要素を使用してください。

configuration
  <の起動>
    <requiredRuntime>

構文

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

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
version 省略可能な属性です。

このアプリケーションがサポートする .NET Framework のバージョンを指定する文字列値。 この文字列値は、.NET Framework のインストール ルートの下にあるディレクトリ名と一致する必要があります。 文字列値の内容は解析されません。
safemode 省略可能な属性です。

ランタイムのスタートアップ コードでレジストリを検索してランタイム バージョンを確認するかどうかを指定します。

safemode 属性

[値] 説明
false ランタイム スタートアップ コードで、レジストリを検索します。 これが既定値です。
true ランタイム スタート アップコードで、レジストリを検索しません。

子要素

なし。

親要素

要素 説明
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
startup <requiredRuntime> 要素が格納されます。

解説

ランタイムのバージョン 1.0 のみをサポートするアプリケーションでは、<requiredRuntime> 要素を使用する必要があります。 ランタイムのバージョン 1.1 以降を使用しているアプリケーションでは、<supportedRuntime> 要素を使用する必要があります。

Note

CorBindToRuntimeByCfg 関数を使用して構成ファイルを指定する場合は、すべてのバージョンのランタイムに <requiredRuntime> 要素を使用する必要があります。 CorBindToRuntimeByCfg を使用すると、<supportedRuntime> 要素は無視されます。

version 属性の文字列は、指定されたバージョンの .NET Framework のインストール フォルダー名と一致している必要があります。 この文字列は解釈されません。 ランタイム スタートアップ コードで一致するフォルダーが見つからなかった場合、ランタイムは読み込まれません。スタートアップ コードによってエラー メッセージが表示され、操作が終了します。

例

ランタイムのバージョンを構成ファイルで指定する例を次に示します。

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

関連項目