элемент <startup>

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

<configuration>   <startup>

Синтаксис

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

Атрибуты и элементы

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

Attributes

Свойство Description
useLegacyV2RuntimeActivationPolicy Необязательный атрибут.

Указывает, следует ли включить политику активации среды выполнения .NET Framework 2.0 или использовать политику активации .NET Framework 4.

атрибут useLegacyV2RuntimeActivationPolicy

Ценность Description
true Включите политику активации среды выполнения .NET Framework 2.0 для выбранной среды выполнения, которая позволяет привязать устаревшие методы активации среды выполнения (например , функцию CorBindToRuntimeEx) к среде выполнения, выбранной из файла конфигурации, вместо ограничения их в среде CLR версии 2.0. Таким образом, если среда CLR версии 4 или более поздней выбирается из файла конфигурации, сборки смешанного режима, созданные с более ранними версиями .NET Framework, загружаются с выбранной версией СРЕДЫ CLR. Установка этого значения предотвращает загрузку среды CLR версии 1.1 или CLR версии 2.0 в тот же процесс, эффективно отключая функцию параллельного процесса.
false Используйте политику активации по умолчанию для .NET Framework 4 и более поздних версий, что позволяет устаревшим методам активации среды выполнения загружать среду CLR версии 1.1 или 2.0 в процесс. Установка этого значения предотвращает загрузку сборок смешанного режима в .NET Framework 4 или более поздней версии, если они не были созданы с помощью .NET Framework 4 или более поздней версии. Это значение по умолчанию.

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

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

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

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

Замечания

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

Атрибут useLegacyV2RuntimeActivationPolicy

Этот атрибут полезен, если приложение использует устаревшие пути активации, например функцию CorBindToRuntimeEx, и вы хотите, чтобы эти пути активировали версию 4 среды CLR вместо более ранней версии, или если приложение создано с помощью .NET Framework 4, но имеет зависимость от сборки смешанного режима, созданной с более ранней версией .NET Framework. В этих сценариях задайте для атрибута trueзначение .

Замечание

Установка атрибута для true предотвращения загрузки среды CLR версии 1.1 или СРЕДЫ CLR версии 2.0 в тот же процесс, эффективно отключая функцию параллельного выполнения (см. раздел " Параллельное выполнение COM-взаимодействия").

Example

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

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

См. также