<Элемент requiredRuntime>

Статья
04/08/2023

Указывает, что приложение поддерживает только версию 1.0 среды CLR. Этот элемент является нерекомендуемой и больше не должен использоваться. Вместо supportedRuntime него следует использовать элемент .

<Конфигурации>
<Запуска>
<RequiredRuntime>

Синтаксис

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

Элементы и атрибуты

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание

version Необязательный атрибут.

Строковое значение, указывающее версию платформа .NET Framework, которую поддерживает это приложение. Строковое значение должно соответствовать имени каталога, найденного в корневом каталоге установки платформа .NET Framework. Содержимое строкового значения не анализируется.

safemode Необязательный атрибут.

Указывает, выполняет ли код запуска среды выполнения поиск в реестре для определения версии среды выполнения.

Атрибут	Описание
`version`	Необязательный атрибут. Строковое значение, указывающее версию платформа .NET Framework, которую поддерживает это приложение. Строковое значение должно соответствовать имени каталога, найденного в корневом каталоге установки платформа .NET Framework. Содержимое строкового значения не анализируется.
`safemode`	Необязательный атрибут. Указывает, выполняет ли код запуска среды выполнения поиск в реестре для определения версии среды выполнения.

Атрибут safemode

Значение	Описание
`false`	Код запуска среды выполнения выполняет поиск в реестре. Это значение по умолчанию.
`true`	Код запуска среды выполнения не отображается в реестре.

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент	Описание
`configuration`	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.
`startup`	Содержит `<requiredRuntime>` элемент .

Приложения, созданные для поддержки только версии 1.0 среды выполнения, должны использовать <requiredRuntime> элемент . Приложения, созданные с использованием среды выполнения версии 1.1 или более поздней, должны использовать <supportedRuntime> элемент .

Примечание

Если вы используете функцию CorBindToRuntimeByCfg для указания файла конфигурации, необходимо использовать <requiredRuntime> элемент для всех версий среды выполнения. Элемент <supportedRuntime> игнорируется при использовании CorBindToRuntimeByCfg.

Строка version атрибута должна соответствовать имени папки установки для указанной версии платформа .NET Framework. Эта строка не интерпретируется. Если код запуска среды выполнения не находит соответствующую папку, среда выполнения не загружается; Код запуска отображает сообщение об ошибке и завершает работу.

Пример

В следующем примере показано, как указать версию среды выполнения в файле конфигурации.

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

Поделиться через