<supportedRuntime> 요소

 

응용 프로그램이 지원하는 공용 언어 런타임 버전을 지정합니다. 이 요소는 .NET Framework 1.1 이상 버전으로 작성된 모든 응용 프로그램에서 사용되어야 합니다.

<configuration>

<startup>

<supportedRuntime>

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

특성설명
버전선택적 특성입니다.

응용 프로그램이 지원하는 공용 언어 런타임(CLR) 버전을 지정하는 문자열 값입니다.version 특성의 유효한 값에 대해서는 "런타임 버전" 값 섹션을 참조하세요. Note: .NET Framework 3.5에서는 "런타임 버전" 값이 major.minor.build 형식을 취합니다..NET Framework 4부터는 주 및 부 버전 번호만 필요합니다(즉, "v4.0.30319"가 아니라 "v4.0"만 필요). 짧은 문자열이 권장됩니다.
sku선택적 특성입니다.

이 응용 프로그램이 지원하는 .NET Framework 버전을 지정하는 SKU(Stock Keeping Unit)를 지정하는 문자열 값입니다.

.NET Framework 4.0을 시작할 때에는 sku 특성을 사용하는 것이 좋습니다. 존재한다면 앱이 대상으로 하는 .NET Framework의 버전을 나타냅니다.

SKU 특성의 유효한 값에 대해서는 "sku id" 값 섹션을 참조하세요.

<supportedRuntime> 요소가 응용 프로그램 구성 파일에 없다면, 응용 프로그램 빌드에 사용된 런타임 버전이 사용됩니다.

<supportedRuntime> 요소는 런타임 버전 1.1 이상으로 작성된 모든 응용 프로그램에서 사용되어야 합니다. 런타임 버전 1.0만 지원하도록 작성된 응용 프로그램은 <requiredRuntime> 요소를 사용해야 합니다.

System_CAPS_ICON_note.jpg 참고

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

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

System_CAPS_ICON_note.jpg 참고

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

실행할 수 있는 모든 .NET Framework 버전을 사용하여 응용 프로그램을 테스트하는 것이 좋습니다.

다음 표에 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"v4.0"
4.5"v4.0"
4.5.1"v4.0"
4.5.2"v4.0"
4.6"v4.0"
4.6.1"v4.0"

다음 표에 sku 특성이 지원하는 .NET Framework 버전이 .NET Framework 4부터 나와 있습니다. .NET Framework 4로 시작하는 sku 특성은 앱이 대상으로 하는 .NET Framework 버전을 나타냅니다.

.NET Framework 버전sku 특성
4.0".NETFramework,Version=v4.0"
4.0, Client Profile".NETFramework,Version=v4.0,Profile=Client"
4.0, 플랫폼 업데이트 1.NETFramework,Version=v4.0.1
4.0, Client Profile, 업데이트 1.NETFramework,Version=v4.0.1,Profile=Client
4.0, 플랫폼 업데이트 2.NETFramework,Version=v4.0.2
4.0, Client Profile, 업데이트 2.NETFramework,Version=v4.0.2,Profile=Client
4.0, 플랫폼 업데이트 3.NETFramework,Version=v4.0.3
4.0, Client Profile, 업데이트 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"

다음 표는 version 특성이 v 4.0이고 sku 특성이 .NET Framework 4 또는 해당 PU(플랫폼 업데이트) 중 하나를 식별할 때, 서로 다른 sku 특성 값에 대해 설치된 .NET Framework 4 버전 중 어느 버전에서 응용 프로그램이 실행될 것인지를 보여줍니다.

sku 특성 값4.0 Client4.0 Full4.0 Client + PU 14.0 Full + PU 14.0 Client + PU 24.0 Full + PU 24.0 Client + PU 34.0 Full + PU 34.5 이상
.NETFramework,Version=v4.0,Profile=Client
.NETFramework,Version=v4.0
.NETFramework,Version=v4.0.1,Profile=Client
.NETFramework,Version=v4.0.1
.NETFramework,Version=v4.0.2,Profile=Client
.NETFramework,Version=v4.0.2
.NETFramework,Version=v4.0.3,Profile=Client
.NETFramework,Version=v4.0.3

다음 예제에서는 구성 파일에 지원되는 런타임 버전을 지정하는 방법을 보여줍니다. 이 구성 파일은 응용 프로그램이 .NET Framework 4.6을 대상으로 함을 나타냅니다.

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

이 요소는 응용 프로그램 구성 파일에 사용할 수 있습니다.

시작 설정 스키마
구성 파일 스키마
<PaveOver> 사용할 런타임 버전 지정
In-Process Side-by-Side 실행

표시: