다음을 통해 공유

<supportedRuntime> 요소

공용 언어 런타임 버전 및 필요에 따라 애플리케이션에서 지원하는 .NET Framework 버전을 지정합니다.

<구성><시작><지원Runtime>

문법

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

Attributes

특성 Description
version 선택적 특성입니다.

이 애플리케이션에서 지원하는 CLR(공용 언어 런타임)의 버전을 지정하는 문자열 값입니다. 특성의 유효한 값은 version"런타임 버전" 값 섹션을 참조하세요. 메모: .NET Framework 3.5를 통해 "런타임 버전" 값은 주 형식을 사용합니다. minor. 빌드합니다. .NET Framework 4부터 주 버전 및 부 버전 번호만 필요합니다(즉, "v4.0.30319" 대신 "v4.0"). 짧은 문자열을 사용하는 것이 좋습니다.
sku 선택적 특성입니다.

SKU(주식 유지 단위)를 지정하는 문자열 값으로, 이 애플리케이션에서 지원하는 .NET Framework 릴리스를 지정합니다.

.NET Framework 4.0부터 특성을 사용하는 sku 것이 좋습니다. 있는 경우 앱이 대상으로 하는 .NET Framework의 버전을 나타냅니다.

특성의 유효한 값은 sku"SKU ID" 값 섹션을 참조하세요.

비고

<supportedRuntime> 요소가 애플리케이션 구성 파일에 없는 경우 애플리케이션을 빌드하는 데 사용되는 런타임 버전이 사용됩니다.

이 <supportedRuntime> 요소는 런타임 버전 1.1 이상을 사용하여 빌드된 모든 애플리케이션에서 사용해야 합니다. 런타임 버전 1.0만 지원하도록 빌드된 애플리케이션은 requiredRuntime> 요소를 사용해야< 합니다.

비고

CorBindToRuntimeByCfg 함수를 사용하여 구성 파일을 지정하는 경우 모든 버전의 런타임에 해당 요소를 사용해야 <requiredRuntime> 합니다. <supportedRuntime> CorBindToRuntimeByCfg를 사용하는 경우 요소가 무시됩니다.

.NET Framework 1.1에서 3.5까지의 런타임 버전을 지원하는 앱의 경우 여러 버전의 런타임이 지원되는 경우 첫 번째 요소는 가장 선호하는 런타임 버전을 지정해야 하며 마지막 요소는 최소 기본 버전을 지정해야 합니다. .NET Framework 4.0 이상 버전을 version 지원하는 앱의 경우 특성은 .NET Framework 4 이상 버전에 공통적인 CLR 버전을 나타내며 sku , 특성은 앱이 대상으로 하는 단일 .NET Framework 버전을 나타냅니다.

특성이 <supportedRuntime>sku 있는 요소가 구성 파일에 있고 설치된 .NET Framework 버전이 지정된 지원되는 버전보다 낮으면 애플리케이션이 실행되지 않고 지원되는 버전을 설치하라는 메시지가 표시됩니다. 그렇지 않으면 애플리케이션이 설치된 버전에서 실행하려고 시도하지만 해당 버전과 완전히 호환되지 않으면 예기치 않게 동작할 수 있습니다. (.NET Framework 버전 간의 호환성 차이는 .NET Framework의 애플리케이션 호환성을 참조하세요.) 따라서 더 쉬운 오류 진단을 위해 애플리케이션 구성 파일에 이 요소를 포함하는 것이 좋습니다. (새 프로젝트를 만들 때 Visual Studio에서 자동으로 생성되는 구성 파일에 이미 포함되어 있습니다.)

비고

애플리케이션이 CorBindToRuntimeEx 함수와 같은 레거시 활성화 경로를 사용하고 해당 경로가 이전 버전 대신 CLR 버전 4를 활성화하도록 하려는 경우 또는 애플리케이션이 .NET Framework 4로 빌드되었지만 이전 버전의 .NET Framework로 빌드된 혼합 모드 어셈블리에 종속되어 있는 경우 지원되는 런타임 목록에서 .NET Framework 4를 지정하는 것으로는 충분하지 않습니다. 또한 구성 파일의 <startup> 요소에서 특성을 true.로 설정 useLegacyV2RuntimeActivationPolicy 해야 합니다. 그러나 이 특성을 설정하면 true 이전 버전의 .NET Framework로 빌드된 모든 구성 요소가 빌드된 런타임 대신 .NET Framework 4를 사용하여 실행됩니다.

실행할 수 있는 모든 .NET Framework 버전으로 애플리케이션을 테스트하는 것이 좋습니다.

"런타임 버전" 값

특성은 runtime 지정된 애플리케이션에 필요한 CLR(공용 언어 런타임) 버전을 지정합니다. 모든 .NET Framework v4.x 버전은 CLR을 지정합니다 v4.0 . 다음 표에서는 특성의 런타임 버전 값에 유효한 값을 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 버전을 나타냅니다. 다음 표에서는 .NET Framework 4부터 특성에서 sku 지원하는 유효한 값을 나열합니다.

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

구성 파일

이 요소는 애플리케이션 구성 파일에서 사용할 수 있습니다.

참고하십시오

  • Last updated on