WebControl.Enabled 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
웹 서버 컨트롤을 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
public:
virtual property bool Enabled { bool get(); void set(bool value); };[System.ComponentModel.Bindable(true)]
public virtual bool Enabled { get; set; }[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public virtual bool Enabled { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Enabled : bool with get, set[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
member this.Enabled : bool with get, setPublic Overridable Property Enabled As Boolean속성 값
true입니다.
- 특성
예제
다음 예제에서는 속성을 프로그래밍 방식으로 설정하여 기본 클래스에서 상속된 컨트롤을 WebControl 사용하거나 사용하지 않도록 설정하는 TextBoxEnabled 방법을 보여 줍니다.
메모
다음 코드 샘플에서는 단일 파일 코드 모델을 사용하며 코드 숨김 파일에 직접 복사한 경우 제대로 작동하지 않을 수 있습니다. 이 코드 샘플은 .aspx 확장이 있는 빈 텍스트 파일로 복사해야 합니다. Web Forms 코드 모델에 대한 자세한 내용은 ASP.NET Web Forms 페이지 코드 모델을 참조하세요.
중요합니다
이 예제에는 잠재적인 보안 위협인 사용자 입력을 허용하는 텍스트 상자가 있습니다. 기본적으로 ASP.NET 웹 페이지는 사용자 입력에 스크립트 또는 HTML 요소가 포함되지 않는지 확인합니다. 자세한 내용은 스크립트 악용 개요를 참조하세요.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void SubmitBtn1_Click(object sender, EventArgs e)
{
TextBox1.Enabled = (!TextBox1.Enabled);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Enabled Property of a Web Control</h3>
<p>
<asp:TextBox id="TextBox1" BackColor="LightBlue"
runat="server">Light Blue</asp:TextBox>
</p>
<p>
<asp:TextBox id="TextBox2" BackColor="LightGreen"
runat="server">Light Green</asp:TextBox>
</p>
<asp:Button id="SubmitBtn1" runat="server"
Text="Click to disable or enable the light blue text box"
OnClick="SubmitBtn1_Click" />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub SubmitBtn1_Click(ByVal sender As Object, ByVal e As EventArgs)
TextBox1.Enabled = Not (TextBox1.Enabled)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Enabled Property of a Web Control</h3>
<p>
<asp:TextBox id="TextBox1" BackColor="LightBlue"
runat="server">Light Blue</asp:TextBox>
</p>
<p>
<asp:TextBox id="TextBox2" BackColor="LightGreen"
runat="server">Light Green</asp:TextBox>
</p>
<asp:Button id="SubmitBtn1" runat="server"
Text="Click to disable or enable the light blue text box"
OnClick="SubmitBtn1_Click" />
</div>
</form>
</body>
</html>
설명
컨트롤의 Enabled 속성을 설정 false하면 컨트롤은 일반적으로 흐리게 표시 됩니다. 컨트롤이 입력 요소인 경우 브라우저는 사용자가 컨트롤을 클릭하거나 입력하지 못하도록 차단합니다. 서버 컨트롤에 대해 렌더링되는 HTML 요소는 해당 특성 또는 해당 CSS class 특성을 설정 disabled 하여 비활성화된 것으로 표시됩니다. 자세한 내용은 SupportsDisabledAttribute 및 ControlRenderingCompatibilityVersion를 참조하세요.
이 속성은 컨트롤 계층 구조 아래로 전파됩니다. 컨테이너 컨트롤을 사용하지 않도록 설정하면 해당 컨테이너 내의 자식 컨트롤도 사용하지 않도록 설정됩니다. 자세한 내용은 IsEnabled 속성을 참조하세요.
메모
사용자 지정 복합 컨트롤에서 이 상속 동작은 아직 자식 컨트롤을 만들지 않은 컨트롤에는 적용되지 않습니다. 자식 컨트롤을 만들 때 자식 컨트롤의 사용 상태를 설정하거나 메서드를 호출하도록 속성을 재정의 EnabledEnsureChildControls 해야 합니다.
메모
컨트롤을 사용하지 않도록 설정하면 브라우저 UI를 통해 사용자가 컨트롤과 상호 작용할 수 없게 됩니다. 페이지에서 컨트롤을 사용할 수 없더라도 사용자가 페이지에서 처리되는 포스트백을 제출하는 요청을 작성할 수 있습니다. 포스트백 요청을 처리하기 전에 컨트롤이 활성화되고 표시되는지 확인합니다.
모든 컨트롤이 이 속성을 지원하는 것은 아닙니다. 자세한 내용은 개별 컨트롤을 참조하세요.
이 속성은 테마 또는 스타일시트 테마로 설정할 수 없습니다. 자세한 내용은 테마 및 스킨을 참조ThemeableAttribute하고 ASP.NET.
