다음을 통해 공유


Control.RenderingCompatibility 속성

정의

렌더링된 HTML이 호환될 ASP.NET 버전을 지정하는 값을 가져옵니다.

public:
 virtual property Version ^ RenderingCompatibility { Version ^ get(); void set(Version ^ value); };
[System.ComponentModel.Bindable(false)]
[System.ComponentModel.Browsable(false)]
public virtual Version RenderingCompatibility { get; set; }
[<System.ComponentModel.Bindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.RenderingCompatibility : Version with get, set
Public Overridable Property RenderingCompatibility As Version

속성 값

Version

렌더링된 HTML이 호환될 ASP.NET 버전입니다.

특성

설명

ASP.NET 이 속성을 Web.config 파일의 controlRenderingCompatibilityVersion pages 요소 특성 값으로 설정합니다. 특성이 controlRenderingCompatibilityVersion Web.config 파일에 설정되지 않은 경우 기본값은 현재 버전의 ASP.NET.

주의

이 속성에 대한 공용 집합 접근자가 있지만 set 접근자는 .NET Framework 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 코드에서 이 값을 설정하면 결과를 예측할 수 없습니다.

ASP.NET 각 릴리스는 이전 릴리스와 다르게 HTML을 렌더링할 수 있습니다. 예를 들어 ASP.NET 3.5 IsEnabled 에서 컨트롤의 Label 속성이 false기본적으로 ASP.NET 특성이 disabled "disabled"로 설정된 요소를 렌더링합니다span. ASP.NET 4에서는 기본적으로 span 요소가 특성 대신 disabled CSS(계단식 스타일시트) class 특성으로 렌더링됩니다. 이렇게 하면 컨트롤의 비활성화된 모양을 지정하고 잘못된 HTML 렌더링을 방지할 수 있습니다. HTML 4.0 및 XHTML 1.1에서는 span 요소가 특성을 지원하지 disabled 않습니다.

웹 애플리케이션 HTML 렌더링을 변경 하는 경우 제대로 작동 하지는 코드를 포함할 수 있습니다. 이 문제를 방지하려면 Web.config 파일에서 요소의 pages 특성을 설정 controlRenderingCompatibilityVersion 하여 호환성을 유지하려는 이전 버전을 나타낼 수 있습니다. 예를 들어 속성을 3.5설정 RenderingCompatibility 하면 비활성화 Label 된 컨트롤이 CSS 클래스가 disabled 아닌 특성을 렌더링합니다.

참고

이 속성을 설정할 수 있는 가장 빠른 버전은 .입니다 3.5.

이전 버전과의 호환성을 유지하기 위해 Visual Studio 사용하여 웹 프로젝트를 이전 버전에서 ASP.NET 4로 업그레이드하는 경우 Visual Studio Web.config 파일3.5의 특성을 자동으로 설정합니다controlRenderingCompatibilityVersion. 업그레이드된 웹 사이트에서 ASP.NET 4에 도입된 알고리즘을 사용하여 HTML을 렌더링하려면 특성을 변경하거나 제거할 controlRenderingCompatibilityVersion 수 있습니다.

대부분의 경우 이 속성에 의해 제어되는 동작은 자동이며 코드에서 속성을 확인할 RenderingCompatibility 필요가 없습니다. 그러나 사용자 지정 컨트롤을 프로그래밍하는 경우 이 속성의 설정에 따라 컨트롤의 동작을 변경하는 코드를 포함해야 할 수 있습니다. 예를 들어 ASP.NET 4에 Label 대한 사용자 지정 컨트롤은 컨트롤로 구성될 수 있으며, 사용자 지정 컨트롤은 클래스를 변경하는 aspNetDisabled JavaScript 코드를 생성하여 컨트롤의 비활성화된 모양을 지정할 수 있습니다. 이 작업은 있는 경우 RenderingCompatibility 4.0 예상대로 작동합니다. 그러나 같은 효과를 RenderingCompatibility 얻으려면 사용자 지정 컨트롤의 코드는 3.5속성이 있을 때 IsEnabled false컨트롤의 CssClass 속성을 "aspNetDisabled"로 설정해야 합니다.

적용 대상

추가 정보