Бөлісу құралы:


элемент <supportedRuntime>

Указывает версию среды CLR и, при необходимости, версию .NET Framework, которую поддерживает приложение.

<configuration>   <startup>     <supportedRuntime>

Синтаксис

<supportedRuntime version="runtime version" sku="SKU ID"/>

Attributes

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

Строковое значение, указывающее версию среды CLR, которую поддерживает это приложение. Допустимые значения атрибута version см. в разделе "Версия среды выполнения". Заметка: В .NET Framework 3.5 значение среды выполнения принимает основное значение формы. дополнительный. сборка. Начиная с .NET Framework 4, требуются только основные и дополнительные номера версий (т. е. версии 4.0 вместо версии 4.0.30319). Рекомендуется использовать более короткую строку.
SKU Необязательный атрибут.

Строковое значение, указывающее единицу хранения запасов (SKU), которая, в свою очередь, указывает, какой выпуск .NET Framework поддерживает это приложение.

Начиная с .NET Framework 4.0 рекомендуется использовать sku атрибут. При наличии она указывает версию платформы .NET Framework, предназначенную для приложения.

Допустимые значения атрибута sku см. в разделе "Идентификатор SKU".

Замечания

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

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

Замечание

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

Для приложений, поддерживающих версии среды выполнения из .NET Framework 1.1–3.5, если поддерживаются несколько версий среды выполнения, первый элемент должен указывать наиболее предпочтительную версию среды выполнения, а последний элемент должен указывать наименее предпочтительную версию. Для приложений, поддерживающих .NET Framework 4.0 или более поздних версий, version атрибут указывает версию СРЕДЫ CLR, общую для .NET Framework 4 и более поздних версий, а sku атрибут указывает одну версию .NET Framework, предназначенную для приложения.

<supportedRuntime> Если элемент с sku атрибутом присутствует в файле конфигурации, а установленная версия .NET Framework ниже указанной поддерживаемой версии, приложение не сможет запуститься и вместо этого отобразит сообщение с просьбой установить поддерживаемую версию. В противном случае приложение пытается запуститься в любой установленной версии, но может неожиданно вести себя, если она не полностью совместима с этой версией. (Различия в совместимости между версиями .NET Framework см. в статье о совместимости приложений в .NET Framework.) Поэтому рекомендуется включить этот элемент в файл конфигурации приложения для упрощения диагностики ошибок. (Файл конфигурации, автоматически созданный Visual Studio при создании нового проекта, уже содержит его.)

Замечание

Если приложение использует устаревшие пути активации, например функцию CorBindToRuntimeEx, и вы хотите, чтобы эти пути активировали версию 4 среды CLR вместо более ранней версии или если приложение создано с помощью .NET Framework 4, но имеет зависимость от сборки смешанного режима, созданной с помощью более ранней версии .NET Framework, Недостаточно указать .NET Framework 4 в списке поддерживаемых сред выполнения. Кроме того, в элементе<startup> в файле конфигурации необходимо задать для атрибута useLegacyV2RuntimeActivationPolicytrueзначение . Однако установка этого атрибута true означает, что все компоненты, созданные с более ранними версиями .NET Framework, выполняются с помощью .NET Framework 4 вместо созданных сред выполнения.

Рекомендуется протестировать приложения со всеми версиями .NET Framework, на которые они могут работать.

Значения "версия среды выполнения"

Атрибут runtime задает версию среды CLR, необходимую для данного приложения. Все версии .NET Framework версии 4.x указывают v4.0 среду CLR. В следующей таблице перечислены допустимые значения для значения версии среды выполнения атрибута version .

Версия платформы .NET Framework Атрибут version
1.0 "v1.0.3705"
1.1 "v1.1.4322"
2.0 "v2.0.50727"
3.0 "v2.0.50727"
3.5 "v2.0.50727"
4.0-4.8.1 "v4.0"

Значения SKU ID

Атрибут sku использует моникер целевой платформы (TFM), чтобы указать версию .NET Framework, которую предназначено для приложения и требуется запустить. В следующей таблице перечислены допустимые значения, поддерживаемые атрибутом sku , начиная с .NET Framework 4.

Версия платформы .NET Framework Атрибут sku
4.0 ". NETFramework,Version=v4.0"
4.0, профиль клиента ". NETFramework,Version=v4.0,Profile=Client"
4.0, обновление платформы 1 ". NETFramework,Version=v4.0.1"
4.0, профиль клиента, обновление 1 ". NETFramework,Version=v4.0.1,Profile=Client"
4.0, обновление платформы 2 ". NETFramework,Version=v4.0.2"
4.0, профиль клиента, обновление 2 ". NETFramework,Version=v4.0.2,Profile=Client"
4.0, обновление платформы 3 ". NETFramework,Version=v4.0.3"
4.0, профиль клиента, обновление 3 ". NETFramework,Version=v4.0.3,Profile=Client"
4,5 ". NETFramework,Version=v4.5"
4.5.1 ". NETFramework,Version=v4.5.1"
4.5.2 ". NETFramework,Version=v4.5.2"
4,6 ". NETFramework,Version=v4.6"
4.6.1 ". NETFramework,Version=v4.6.1"
4.6.2 ". NETFramework,Version=v4.6.2"
4,7 ". NETFramework,Version=v4.7"
4.7.1 ". NETFramework,Version=v4.7.1"
4.7.2 ". NETFramework,Version=v4.7.2"
4.8 ". NETFramework,Version=v4.8"
4.8.1 ". NETFramework,Version=v4.8.1"

Example

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

<configuration>
   <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
   </startup>
</configuration>

Файл конфигурации

Этот элемент можно использовать в файле конфигурации приложения.

См. также