WebControl.SupportsDisabledAttribute 속성

정의

컨트롤의 IsEnabled 속성이 false인 경우 컨트롤이 렌더링된 HTML 요소의 disabled 특성을 "disabled"로 설정할지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

public:
 virtual property bool SupportsDisabledAttribute { bool get(); };
[System.ComponentModel.Browsable(false)]
public virtual bool SupportsDisabledAttribute { get; }
[<System.ComponentModel.Browsable(false)>]
member this.SupportsDisabledAttribute : bool
Public Overridable ReadOnly Property SupportsDisabledAttribute As Boolean

속성 값

Boolean

항상 true입니다.Always true.

특성

예제

다음 예제에서는 비활성화 된에 대 한 태그를 보여 줍니다. Label 제어 합니다.The following example shows markup for a disabled Label control:

<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>

ASP.NET 3.5 및 이전 버전에서이 태그는 다음 HTML을 렌더링합니다.In ASP.NET 3.5 and earlier versions, this markup renders the following HTML:

<span id="Label1" disabled="disabled">Test</span>

ASP.NET 4에서 경우 값을 RenderingCompatibility 속성은 4.0 이상의 경우는 DisabledCssClass 속성을 기본값으로 설정 하면 동일한 태그를 다음 HTML을 렌더링:In ASP.NET 4, if the value of the RenderingCompatibility property is 4.0 or greater, and if the DisabledCssClass property is set to its default value, the same markup renders the following HTML:

<span id="Label1" class="aspNetDisabled">Test</span>

설명

파생된 클래스에서이 속성 방법을 ASP.NET 렌더링할지 나타냅니다 HTML 컨트롤에 대 한 컨트롤은 사용 하지 않도록 설정 합니다.In derived classes, this property indicates how ASP.NET should render HTML for a control when the control is disabled.

사용 하지 않도록 설정 하는 ASP.NET 웹 컨트롤Disabling ASP.NET Web Controls

경우는 Enabled ASP.NET 컨트롤의 속성이 false (즉, 경우 컨트롤은 사용 안 함), ASP.NET 페이지에서 컨트롤을 렌더링 해야 하지만 (일반적으로 흐리게 표시) 비활성 상태로 표시 하는 합니다.When the Enabled property of an ASP.NET control is set to false (that is, when the control is disabled), the intent is that ASP.NET should render the control in the page, but display it in a disabled state (typically dimmed). 부모 컨트롤을 사용 하지 않도록 설정 하는 경우 해당 컨트롤의 자식 항목 사용 안 함으로 표시 됩니다.If a parent control is disabled, children of that control are also displayed as disabled. 이런 경우, 자식 컨트롤의 IsEnabled 속성이 false경우에 해당 Enabled 속성 설정할 수 있습니다 true합니다.In that case, the child control's IsEnabled property is set to false, even though its Enabled property might be set to true.

ASP.NET 3.5 및 이전 버전의 경우 컨트롤의 IsEnabled 속성은 false, ASP.NET 집합은 disabled 컨트롤 렌더링 하는 HTML 요소 특성을 "disabled".In ASP.NET 3.5 and earlier versions, when a control's IsEnabled property is false, ASP.NET sets the disabled attribute to "disabled" in the HTML element that it renders for the control. 그러나 HTML 4.01 표준 허용 된 disabled 사용자 입력에 사용 되는 특정 요소에 대해서만 특성입니다.However, the HTML 4.01 standard allows the disabled attribute only on certain elements that are used for user input. 예를 들어 합니다 disabled 에 대 한 특성을 사용할 수 input 요소인 아닌 span 요소입니다.For example, the disabled attribute is allowed for input elements, but not for span elements.

대부분의 브라우저 표시 전용 요소에 대해 사용 하지 않도록 설정 하는 기본 모양을 지원 disabled 특성입니다.Most browsers support a default disabled appearance for display-only elements that have disabled attributes. 그러나 ASP.NET 4를 기본적으로, HTML 표준을 준수 하기 위해 잘못 된 특성을 생략 합니다.However, in order to comply with HTML standards, by default ASP.NET 4 omits invalid attributes.

SupportsDisabledAttribute 속성을 사용 하는 방법How the SupportsDisabledAttribute Property is Used

경우는 SupportsDisabledAttribute 속성은 true, ASP.NET 렌더링을 disabled 컨트롤이 비활성화 되 면 특성입니다.If the SupportsDisabledAttribute property is true, ASP.NET renders a disabled attribute when the control is disabled. 이 속성이 false, ASP.NET 렌더링을 class 컨트롤이 비활성화 되 면 특성입니다.If this property is false, ASP.NET renders a class attribute when the control is disabled.

파생된 클래스를 반환 하려면이 속성을 재정의 false 다음 조건이 모두 참인 경우:Derived classes override this property to return false if all the following conditions are true:

  • 컨트롤을 지원 하지 않는 HTML 요소를 렌더링 합니다 disabled 특성입니다.The control renders an HTML element that does not support the disabled attribute.

  • RenderingCompatibility 속성 4.0 ASP.NET 버전 번호를 나타냅니다.The RenderingCompatibility property indicates an ASP.NET version number lower than 4.0.

합니다 SupportsDisabledAttribute 속성은 나타내지는 컨트롤에 렌더링 되는 HTML 요소를 지원 하는지 여부를 (허용)는 disabled 특성입니다.The SupportsDisabledAttribute property does not necessarily indicate whether the HTML element that is rendered for a control supports (allows) the disabled attribute. 컨트롤의 RenderingCompatibility 속성에 컨트롤의 값을 4.0 미만의 ASP.NET 버전 번호를 나타냅니다 SupportsDisabledAttribute 속성에서 반환할 수 있습니다 true 렌더링된 된 HTML 지원 하지 않는 경우에는 disabled 특성입니다.If a control's RenderingCompatibility property indicates an ASP.NET version number lower than 4.0, the value of the control's SupportsDisabledAttribute property might return true even if the rendered HTML does not support the disabled attribute.

비활성화 된 컨트롤에 대 한 이전 버전과 호환성Backward Compatibility for Disabled Controls

Visual Studio를 자동으로 설정 하면 Visual Studio를 사용 하 여 이전 버전에서 ASP.NET 4로 웹 프로젝트를 업그레이드 하는 controlRenderingCompatibilityVersion Web.config 파일의 특성 (집합은 RenderingCompatibility 속성) 이전 버전 번호입니다.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 (which sets the RenderingCompatibility property) to the earlier version number. 때문에 SupportsDisabledAttribute 속성은 항상 반환 true 때는 RenderingCompatibility 속성이 4.0, 이렇게 하면 웹 컨트롤을 이전 버전에서와 마찬가지로 사용할 수 없는 컨트롤에 대 한 HTML을 렌더링 합니다.Because the SupportsDisabledAttribute property always returns true when the RenderingCompatibility property is lower than 4.0, this causes Web controls to render HTML for disabled controls as they did in the earlier version. ASP.NET 4에 도입 된 알고리즘을 사용 하 여 HTML을 렌더링 하는 업그레이드 된 웹 사이트를 하려는 경우에 변경 하거나 제거할 수 있습니다는 controlRenderingCompatibilityVersion 특성입니다.If you want an upgraded Web site to render HTML using the algorithm introduced in ASP.NET 4, you can change or remove the controlRenderingCompatibilityVersion attribute. 자세한 내용은 RenderingCompatibility 속성을 참조하세요.For more information, see the RenderingCompatibility property.

CSS를 사용 하 여 비활성화 된 모양 설정Setting a Disabled Appearance By Using CSS

경우는 SupportsDisabledAttribute 컨트롤의 속성은 false 컨트롤은 ASP.NET 집합을 사용할 합니다 class 특성의 값으로 렌더링 된 HTML 요소의 WebControl.DisabledCssClass 속성.If the SupportsDisabledAttribute property of a control is false and the control is disabled, ASP.NET sets the class attribute of the rendered HTML element to the value of the WebControl.DisabledCssClass property. 기본값은 WebControl.DisabledCssClass 속성은 "aspNetDisabled"입니다.The default value of the WebControl.DisabledCssClass property is "aspNetDisabled".

비활성화 된 컨트롤에 대 한 비활성화 된 모양을 제공의 값으로 표현 되는 클래스에 대 한 CSS 규칙을 정의 해야 합니다는 WebControl.DisabledCssClass 속성입니다.To provide a disabled appearance for disabled controls, you must define a CSS rule for the class that is represented by the value of the WebControl.DisabledCssClass property.

HTML 요소를 컨트롤 둘 이상의 값에 있을 수에 대 한 렌더링 되는 해당 class 특성의 값이 있는 경우 해당 CssClass 속성입니다.The HTML element that is rendered for a control might have more than one value in its class attribute if there is a value in its CssClass property. 자세한 내용은 DisabledCssClass 속성을 참조하세요.For more information, see the DisabledCssClass property.

적용 대상

추가 정보