Control.RenderingCompatibility 속성

정의

렌더링된 HTML이 호환될 ASP.NET 버전을 지정하는 값을 가져옵니다.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

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; }
member this.RenderingCompatibility : Version with get, set
Public Overridable Property RenderingCompatibility As Version

속성 값

렌더링된 HTML이 호환될 ASP.NET 버전입니다.The ASP.NET version that rendered HTML will be compatible with.

특성

설명

ASP.NET는 web.config 파일에 있는 pages 요소의 controlRenderingCompatibilityVersion 특성 값으로이 속성을 설정 합니다.ASP.NET sets this property to the value of the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file. Web.config 파일에 controlRenderingCompatibilityVersion 특성이 설정 되지 않은 경우 기본값은 ASP.NET의 현재 버전입니다.If the controlRenderingCompatibilityVersion attribute is not set in the Web.config file, the default value is the current version of ASP.NET.

주의

이 속성에는 public set 접근자가 있지만 set 접근자는 .NET Framework 인프라를 지원 하며 사용자 코드에서 직접 사용 하기 위한 것이 아닙니다.There is a public set accessor for this property, but the set accessor supports the .NET Framework infrastructure and is not intended to be used directly from your code. 코드에서이 값을 설정 하면 예측할 수 없는 효과가 있습니다.If you set this value in your code, the effect is unpredictable.

ASP.NET의 각 릴리스는 이전 릴리스와 다르게 HTML을 렌더링할 수 있습니다.Each release of ASP.NET might render HTML differently from earlier releases. 예를 들어, ASP.NET 3.5에서 Label 컨트롤의 IsEnabled 속성이 false되는 경우 기본적으로 ASP.NET는 disabled 특성이 "disabled"로 설정 된 span 요소를 렌더링 합니다.For example, in ASP.NET 3.5, if the IsEnabled property of a Label control is false, by default, ASP.NET renders a span element whose disabled attribute is set to "disabled". ASP.NET 4에서 기본적으로 span 요소는 disabled 특성 대신 CSS (css 스타일 시트) class 특성을 사용 하 여 렌더링 됩니다.In ASP.NET 4, by default, the span element is rendered with a cascading style sheet (CSS) class attribute instead of the disabled attribute. 이렇게 하면 컨트롤의 비활성화 된 모양을 지정 하 고 잘못 된 HTML 렌더링을 방지할 수 있습니다.This lets you specify the disabled appearance of the control and avoids rendering invalid HTML. HTML 4.0 및 XHTML 1.1에서 span 요소는 disabled 특성을 지원 하지 않습니다.(In HTML 4.0 and XHTML 1.1, the span element does not support the disabled attribute.)

웹 애플리케이션 HTML 렌더링을 변경 하는 경우 제대로 작동 하지는 코드를 포함할 수 있습니다.A Web application might include code that would not function correctly if HTML rendering changes. 이 문제를 방지 하기 위해 web.config 파일에서 pages 요소의 controlRenderingCompatibilityVersion 특성을 설정 하 여 호환성을 유지 하려는 이전 버전을 지정할 수 있습니다.To avoid this problem, you can set the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file to indicate which earlier version you want to maintain compatibility with. 예를 들어 RenderingCompatibility 속성을 3.5로 설정 하면 사용 하지 않도록 설정 된 Label 컨트롤은 CSS 클래스가 아니라 disabled 특성을 렌더링 합니다.For example, if you set the RenderingCompatibility property to 3.5, a disabled Label control will render a disabled attribute and not a CSS class.

참고

이 속성을로 설정할 수 있는 가장 이른 버전은 3.5입니다.The earliest version that you can set this property to is 3.5.

이전 버전과의 호환성을 유지 하기 위해 Visual Studio를 사용 하 여 웹 프로젝트를 이전 버전에서 ASP.NET 4로 업그레이드 하는 경우 Visual Studio는 web.config 파일에 controlRenderingCompatibilityVersion 특성을 자동으로 3.5로 설정 합니다.To maintain backward compatibility, when you use Visual Studio to upgrade a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the controlRenderingCompatibilityVersion attribute in the Web.config file to 3.5. 업그레이드 된 웹 사이트가 ASP.NET 4에서 도입 된 알고리즘을 사용 하 여 HTML을 렌더링 하도록 하려는 경우 controlRenderingCompatibilityVersion 특성을 변경 하거나 제거할 수 있습니다.If you want an upgraded Web site to render HTML using the algorithm that was introduced in ASP.NET 4, you can change or remove the controlRenderingCompatibilityVersion attribute.

대부분의 경우이 속성에 의해 제어 되는 동작은 자동으로 수행 되며 코드에서 RenderingCompatibility 속성을 확인할 필요가 없습니다.Most of the time, the behavior controlled by this property is automatic and you do not have to check the RenderingCompatibility property in your code. 그러나 사용자 지정 컨트롤을 프로그래밍 하는 경우에는이 속성의 설정에 따라 컨트롤의 동작을 변경 하는 코드를 포함 해야 할 수 있습니다.However, if you are programming a custom control, you might have to include code that alters the control's behavior based on the setting of this property. 예를 들어 ASP.NET 4의 사용자 지정 컨트롤은 Label 컨트롤로 구성 될 수 있으며, 사용자 지정 컨트롤은 aspNetDisabled 클래스를 변경 하는 JavaScript 코드를 생성 하 여 컨트롤의 비활성화 된 모양을 지정할 수 있습니다.For example, a custom control for ASP.NET 4 might be composed of Label controls, and the custom control might specify the disabled appearance of the control by generating JavaScript code that alters the aspNetDisabled class. RenderingCompatibility 4.0 이상인 경우에는 예상 대로 작동 합니다.This will work as expected if RenderingCompatibility is 4.0 or later. 그러나 RenderingCompatibility 3.5될 때 동일한 결과를 얻으려면 IsEnabled 속성이 false될 때 사용자 지정 컨트롤의 CssClass 속성을 "aspNetDisabled"로 설정 해야 합니다.But to get the same effect when RenderingCompatibility is 3.5, the custom control's code must set the control's CssClass property to "aspNetDisabled" when the IsEnabled property is false.

적용 대상

추가 정보