<элемент> supportedRuntime<supportedRuntime> element

Указывает, какая версия среды CLR и, при необходимости, .NET Framework версия, поддерживаемая приложением.Specifies which common language runtime version and, optionally, .NET Framework version the application supports.

<>конфигурации<configuration>
  <>запуска  <startup>
    <supportedRuntime>    <supportedRuntime>

СинтаксисSyntax

<supportedRuntime version="runtime version" sku="sku id"/>

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
versionversion Необязательный атрибут.Optional attribute.

Строковое значение, задающее версию среды CLR, которая поддерживается данным приложением.A string value that specifies the version of the common language runtime (CLR) that this application supports. Допустимые значения version атрибута см. в разделе "значения версии среды выполнения" .For valid values of the version attribute, see the "runtime version" values section. Примечание. С помощью .NET Framework 3,5 значение "версия среды выполнения" принимает форму " основной". дополнительный номер. Сборка.Note: Through the .NET Framework 3.5, the "runtime version" value takes the form major.minor.build. Начиная с .NET Framework 4, требуются только основной и дополнительный номера версии (т. е. "v 4.0" вместо "v 4.0.30319").Beginning with the .NET Framework 4, only the major and minor version numbers are required (that is, "v4.0" instead of "v4.0.30319"). Рекомендуется использовать более короткие строки.The shorter string is recommended.
SKUsku Необязательный атрибут.Optional attribute.

Строковое значение, которое указывает единицу складского хранения (SKU), которая, в свою очередь, указывает выпуск .NET Framework, поддерживаемый этим приложением.A string value that specifies the stock-keeping unit (SKU), which in turn specifies which .NET Framework release this application supports.

Начиная с .NET Framework 4.0, рекомендуется использовать атрибут sku.Starting with the .NET Framework 4.0, the use of the sku attribute is recommended. Если он присутствует, он указывает целевую версию .NET Framework приложения.When present, it indicates the version of the .NET Framework that the app targets.

Допустимые значения атрибута SKU см. в разделе значения номера SKU .For valid values of the sku attribute, see the "sku id" values section.

RemarksRemarks

Если элемент ** <>supportedRuntime** отсутствует в файле конфигурации приложения, используется версия среды выполнения, используемая для построения приложения.If the <supportedRuntime> element is not present in the application configuration file, the version of the runtime used to build the application is used.

Элемент ** <supportedRuntime>** должен использоваться всеми приложениями, созданными с помощью среды выполнения версии 1,1 или более поздней.The <supportedRuntime> element should be used by all applications built using version 1.1 or later of the runtime. Приложения, созданные для поддержки только версии 1,0 среды выполнения, должны использовать элемент <requiredRuntime> .Applications built to support only version 1.0 of the runtime must use the <requiredRuntime> element.

Примечание

При использовании функции корбиндторунтимебикфг для указания файла конфигурации необходимо использовать <requiredRuntime> элемент для всех версий среды выполнения.If you use the CorBindToRuntimeByCfg function to specify the configuration file, you must use the <requiredRuntime> element for all versions of the runtime. При <supportedRuntime> использовании корбиндторунтимебикфгэлемент игнорируется.The <supportedRuntime> element is ignored when you use CorBindToRuntimeByCfg.

Для приложений, поддерживающих версии среды выполнения от .NET Framework 1.1 до 3.5, при поддержке нескольких версий среды выполнения первый элемент должен задавать наиболее предпочтительную версию среды, а последний — наименее предпочтительную.For apps that support versions of the runtime from the .NET Framework 1.1 through 3.5, when multiple versions of the runtime are supported, the first element should specify the most preferred version of the runtime, and the last element should specify the least preferred version. Для приложений, поддерживающих .NET Framework 4,0 или более поздних версий version , атрибут указывает версию среды CLR, которая является общей для .NET Framework 4 и более поздних версий, sku а атрибут указывает на одну версию .NET Framework, для которой предназначено приложение.For apps that support the .NET Framework 4.0 or later versions, the version attribute indicates the CLR version, which is common to the .NET Framework 4 and later versions, and the sku attribute indicates the single .NET Framework version that the app targets.

Если элемент ** <>supportedRuntime** с sku атрибутом содержится в файле конфигурации, а версия установленного .NET Framework ниже указанной поддерживаемой версии, то приложение не запускается, а вместо этого отображается сообщение с запросом на установку поддерживаемой версии.If the <supportedRuntime> element with the sku attribute is present in the configuration file and the installed .NET Framework version is lower then the specified supported version, the application fails to run and instead displays a message asking to install the supported version. В противном случае приложение пытается запуститься в любой установленной версии, но может вести себя неожиданно, если она не полностью совместима с этой версией.Otherwise, the application attempts to run on any installed version, but it may behave unexpectedly if it is not fully compatible with that version. (Сведения о различиях в совместимости версий .NET Framework см. в разделе Совместимость приложений в .NET Framework.) Поэтому рекомендуется включить этот элемент в файл конфигурации приложения для упрощения диагностики ошибок.(For compatibility differences between versions of .NET Framework, see Application compatibility in the .NET Framework.) Therefore, we recommend that you include this element in the application configuration file for easier error diagnostics. (Файл конфигурации, автоматически созданный Visual Studio при создании нового проекта, уже содержит его.)(The configuration file automatically generated by Visual Studio when creating a new project already contains it.)

Примечание

Если ваше приложение использует пути активации прежних версий, например функцию CorBindToRuntimeEx, и вы хотите, чтобы эти пути активировали версию 4 среды CLR вместо более ранней версии или если приложение создано с .NET Framework 4, но имеет зависимость от сборки в смешанном режиме, построенной с использованием более ранней версии .NET Framework, не достаточно указать .NET Framework 4 в списке поддерживаемых сред выполнения.If your application uses legacy activation paths, such as the CorBindToRuntimeEx function, and you want those paths to activate version 4 of the CLR instead of an earlier version, or if your application is built with the .NET Framework 4 but has a dependency on a mixed-mode assembly built with an earlier version of the .NET Framework, it is not sufficient to specify the .NET Framework 4 in the list of supported runtimes. Кроме того useLegacyV2RuntimeActivationPolicy true <, в элементе Startup> в файле конфигурации необходимо задать для атрибута значение.In addition, in the <startup> element in your configuration file, you must set the useLegacyV2RuntimeActivationPolicy attribute to true. Однако установка этого атрибута true означает, что все компоненты, созданные с помощью более ранних версий .NET Framework, выполняются с использованием .NET Framework 4 вместо сред выполнения, в которых они были созданы.However, setting this attribute to true means that all components built with earlier versions of the .NET Framework are run using the .NET Framework 4 instead of the runtimes they were built with.

Приложения рекомендуется тестировать со всеми версиями .NET Framework, в которых они могут работать.We recommend that you test applications with all the .NET Framework versions that they can run on.

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

runtime Атрибут указывает версию среды CLR, необходимую для данного приложения.The runtime attribute specifies the Common Language Runtime (CLR) version that is required for a given application. Обратите внимание, что все версии .NET Framework v4. v4.0 x указывают среду CLR.Note that all .NET Framework v4.x versions specify the v4.0 CLR. В следующей таблице перечислены допустимые значения для значения Version среды выполнения version атрибута.The following table lists valid values for the runtime version value of the version attribute.

Версия платформы .NET Framework.NET Framework version Атрибут versionversion attribute
1.01.0 "v1.0.3705""v1.0.3705"
1.11.1 "v1.1.4322""v1.1.4322"
2.02.0 "v2.0.50727""v2.0.50727"
3.03.0 "v2.0.50727""v2.0.50727"
3,53.5 "v2.0.50727""v2.0.50727"
4.0 — 4.84.0-4.8 "v4.0""v4.0"

значения "ИД SKU""sku id" values

sku Атрибут использует моникер целевой платформы (TFM) для указания версии .NET Framework, для которой предназначено приложение, и требует выполнения.The sku attribute uses a target framework moniker (TFM) to indicate the version of the .NET Framework that the app targets and requires to run. В следующей таблице перечислены допустимые значения, поддерживаемые sku атрибутом, начиная с .NET Framework 4.The following table lists valid values that are supported by the sku attribute, starting with the .NET Framework 4.

Версия платформы .NET Framework.NET Framework version Атрибут skusku attribute
4,04.0 ".NETFramework,Version=v4.0"".NETFramework,Version=v4.0"
4.0, клиентский профиль4.0, Client Profile ".NETFramework,Version=v4.0,Profile=Client"".NETFramework,Version=v4.0,Profile=Client"
4.0, обновление платформы 14.0, platform update 1 ". NETFramework, Version = v 4.0.1 "".NETFramework,Version=v4.0.1"
4.0, клиентский профиль, обновление 14.0, Client Profile, update 1 ". NETFramework, Version = v 4.0.1, Profile = Client".NETFramework,Version=v4.0.1,Profile=Client"
4.0, обновление платформы 24.0, platform update 2 ". NETFramework, Version = v 4.0.2 "".NETFramework,Version=v4.0.2"
4.0, клиентский профиль, обновление 24.0, Client Profile, update 2 ". NETFramework, Version = v 4.0.2, Profile = Client".NETFramework,Version=v4.0.2,Profile=Client"
4.0, обновление платформы 34.0, platform update 3 ". NETFramework, Version = v 4.0.3 "".NETFramework,Version=v4.0.3"
4.0, клиентский профиль, обновление 34.0, Client Profile, update 3 ". NETFramework, Version = v 4.0.3, Profile = Client".NETFramework,Version=v4.0.3,Profile=Client"
4.5.4.5 ".NETFramework,Version=v4.5"".NETFramework,Version=v4.5"
4.5.14.5.1 ".NETFramework,Version=v4.5.1"".NETFramework,Version=v4.5.1"
4.5.24.5.2 ".NETFramework,Version=v4.5.2"".NETFramework,Version=v4.5.2"
4.64.6 ".NETFramework,Version=v4.6"".NETFramework,Version=v4.6"
4.6.14.6.1 ".NETFramework,Version=v4.6.1"".NETFramework,Version=v4.6.1"
4.6.24.6.2 ". NETFramework, Version = v 4.6.2 "".NETFramework,Version=v4.6.2"
4,74.7 ". NETFramework, Version = v 4.7".NETFramework,Version=v4.7"
4.7.14.7.1 ". NETFramework, Version = v 4.7.1 "".NETFramework,Version=v4.7.1"
4.7.24.7.2 ". NETFramework, Version = v 4.7.2 "".NETFramework,Version=v4.7.2"
4.84.8 ". NETFramework, Version = v 4.8 "".NETFramework,Version=v4.8"

ПримерExample

В следующем примере показано задание в файле конфигурации поддерживаемых версий среды выполнения.The following example shows how to specify the supported runtime version in a configuration file. Файл конфигурации указывает, что приложение предназначено для .NET Framework 4,7.The configuration file indicates that the app targets the .NET Framework 4.7.

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

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

Этот элемент может использоваться в файле конфигурации приложения.This element can be used in the application configuration file.

См. также разделSee also