<Элемент supportedRuntime>

Статья
05/10/2023

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

<configuration>
<Запуска>
<supportedRuntime>

Синтаксис

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

Атрибуты

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

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

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

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

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

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

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

Атрибут	Описание
version	Необязательный атрибут. Строковое значение, задающее версию среды CLR, которая поддерживается данным приложением. Допустимые значения атрибута см. в `version` разделе "Значения версии среды выполнения". Примечание: До платформа .NET Framework 3.5 значение "версия среды выполнения" принимает вид основной. дополнительный. сборка. Начиная с платформа .NET Framework 4, требуются только основные и дополнительные номера версий (то есть "v4.0" вместо "v4.0.30319"). Рекомендуется использовать более короткие строки.
sku	Необязательный атрибут. Строковое значение, которое указывает единицу складского хранения (SKU), которая, в свою очередь, указывает выпуск .NET Framework, поддерживаемый этим приложением. Начиная с платформа .NET Framework 4.0 рекомендуется использовать `sku` атрибут . Если он присутствует, он указывает целевую версию .NET Framework приложения. Допустимые значения атрибута см. в `sku` разделе "Значения идентификатора SKU".

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

Примечание

Если вы используете функцию 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 в списке поддерживаемых сред выполнения. Кроме того, в элементе< запуска> в файле конфигурации необходимо задать атрибуту useLegacyV2RuntimeActivationPolicy значение true. Однако установка этого атрибута в true значение означает, что все компоненты, созданные с помощью более ранних версий платформа .NET Framework, выполняются с помощью платформа .NET Framework 4 вместо сред выполнения, с помощью которых они были созданы.

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

Значения "runtime version"

Атрибут 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"

Атрибут 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"

Пример

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

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

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

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

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