<Supportedruntime> > 요소<supportedRuntime> element

응용 프로그램에서 지 원하는 공용 언어 런타임 버전과 선택적으로 .NET Framework 버전을 지정 합니다.Specifies which common language runtime version and, optionally, .NET Framework version the application supports.

<구성><configuration>
  <startup>  <startup>
     <supportedRuntime>    <supportedRuntime>

구문Syntax

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

특성Attributes

특성Attribute DescriptionDescription
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를 통해 "런타임 버전" 값은 major형식을 사용 합니다. . 빌드.Note: Through the .NET Framework 3.5, the "runtime version" value takes the form major.minor.build. .NET Framework 4부터 주 버전 및 부 버전 번호만 필요 합니다 (즉, "v 4.0.30319" 대신 "v 4.0").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.

이 애플리케이션이 지원하는 .NET Framework 버전을 지정하는 SKU(Stock Keeping Unit)를 지정하는 문자열 값입니다.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 id" 값 섹션을 참조 하세요.For valid values of the sku attribute, see the "sku id" values section.

주의Remarks

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

참고

CorBindToRuntimeByCfg 함수를 사용 하 여 구성 파일을 지정 하는 경우 모든 버전의 런타임에 대해 <requiredRuntime> 요소를 사용 해야 합니다.If you use the CorBindToRuntimeByCfg function to specify the configuration file, you must use the <requiredRuntime> element for all versions of the runtime. CorBindToRuntimeByCfg를 사용 하는 경우 <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 특성은 .NET Framework 4 이상 버전에 공통 된 CLR 버전을 나타내며 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.

구성 파일에 sku 특성을 가진 <supportedruntime> > 요소가 있고 설치 된 .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 함수와같은 레거시 활성화 경로를 사용 하 고 이러한 경로를 사용 하 여 이전 버전 대신 CLR의 버전 4를 활성화 하는 경우 또는 응용 프로그램이 .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. 또한 구성 파일의 <startup > 요소 에서 useLegacyV2RuntimeActivationPolicy 특성을 true로 설정 해야 합니다.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" values

runtime 특성은 지정 된 응용 프로그램에 필요한 CLR (공용 언어 런타임) 버전을 지정 합니다.The runtime attribute specifies the Common Language Runtime (CLR) version that is required for a given application. 모든 .NET Framework (v4. x 버전은 v4.0 CLR을 지정 합니다.Note that all .NET Framework v4.x versions specify the v4.0 CLR. 다음 표에서는 version 특성의 런타임 버전 값에 대 한 유효한 값을 보여 줍니다.The following table lists valid values for the runtime version value of the version attribute.

.NET Framework 버전.NET Framework version version 특성version 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 id" 값"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. 다음 표에서는 .NET Framework 4부터 시작 하 여 sku 특성에서 지원 되는 유효한 값을 보여 줍니다.The following table lists valid values that are supported by the sku attribute, starting with the .NET Framework 4.

.NET Framework 버전.NET Framework version sku 특성sku attribute
4.04.0 ".NETFramework,Version=v4.0"".NETFramework,Version=v4.0"
4.0, Client Profile4.0, Client Profile ".NETFramework,Version=v4.0,Profile=Client"".NETFramework,Version=v4.0,Profile=Client"
4.0, 플랫폼 업데이트 14.0, platform update 1 ".NETFramework,Version=v4.0.1"".NETFramework,Version=v4.0.1"
4.0, Client Profile, 업데이트 14.0, Client Profile, update 1 ".NETFramework,Version=v4.0.1,Profile=Client"".NETFramework,Version=v4.0.1,Profile=Client"
4.0, 플랫폼 업데이트 24.0, platform update 2 ".NETFramework,Version=v4.0.2"".NETFramework,Version=v4.0.2"
4.0, Client Profile, 업데이트 24.0, Client Profile, update 2 ".NETFramework,Version=v4.0.2,Profile=Client"".NETFramework,Version=v4.0.2,Profile=Client"
4.0, 플랫폼 업데이트 34.0, platform update 3 ".NETFramework,Version=v4.0.3"".NETFramework,Version=v4.0.3"
4.0, Client Profile, 업데이트 34.0, Client Profile, update 3 ".NETFramework,Version=v4.0.3,Profile=Client"".NETFramework,Version=v4.0.3,Profile=Client"
4.54.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=v4.6.2"".NETFramework,Version=v4.6.2"
4.74.7 ".NETFramework,Version=v4.7"".NETFramework,Version=v4.7"
4.7.14.7.1 ".NETFramework,Version=v4.7.1"".NETFramework,Version=v4.7.1"
4.7.24.7.2 ".NETFramework,Version=v4.7.2"".NETFramework,Version=v4.7.2"
4.84.8 ".NETFramework,Version=v4.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