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이고, 그렇지 않으면 false입니다. 기본값은 true입니다.
- 특성
예제
다음 예제를 사용 하도록 설정 하 고 사용 하지 않도록 설정 하는 방법을 TextBox 컨트롤에서 상속 합니다 WebControl 설정 하 여 기본 클래스 해당 Enabled 속성 프로그래밍 방식으로 합니다.
참고
다음 코드 샘플 단일 파일 코드 모델을 사용 하 고 코드 숨김 파일에 직접 복사 하는 경우 제대로 작동 하지 않을 수 있습니다. 이 코드 샘플.aspx 확장명이 있는 빈 텍스트 파일에 복사 해야 합니다. Web Forms 코드 모델에 대 한 자세한 내용은 참조 하세요. ASP.NET Web Forms 페이지 코드 모델합니다.
중요
이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다. 자세한 내용은 Script Exploits Overview를 참조하세요.
<%@ 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, 컨트롤 일반적으로 흐리게 표시 합니다. Input 요소를 컨트롤을 사용 하는 경우 브라우저는 사용자가 클릭 하거나 해당 입력을 방지 합니다. 서버 컨트롤에 렌더링 되는 HTML 요소를 설정 하 여 비활성화 된 것으로 표시 된 해당 disabled 특성 또는 해당 CSS class 특성입니다. 자세한 내용은 SupportsDisabledAttribute 및 ControlRenderingCompatibilityVersion를 참조하세요.
이 속성은 컨트롤 계층 구조 아래로 전파합니다. 컨테이너 컨트롤을 비활성화 하면 해당 컨테이너 내의 자식 컨트롤 조건도 비활성화 됩니다. 자세한 내용은 IsEnabled 속성을 참조하세요.
참고
사용자 지정 복합 컨트롤에서 상속 동작은이 컨트롤을 아직 만들지 않은 해당 자식 컨트롤에 적용 되지 않습니다. 설정 해야 설정 된 상태의 자식 컨트롤을 만들어야 하는지 또는 재정의 하는 경우는 Enabled 속성을 호출 합니다 EnsureChildControls 메서드.
참고
컨트롤을 사용 하지 않도록 설정 브라우저 UI 통해 사용자가 컨트롤과 상호 작용만 제한 됩니다. 사용자 페이지의 컨트롤을 사용할 경우에 페이지에 의해 처리 되는 포스트백 전송 하는 요청을 만들 수는 것이 가능 합니다. 포스트백 요청을 처리 하기 전에 컨트롤을 사용 하도록 설정 하 고 볼 수 있는지 확인 합니다.
없거나 일부 컨트롤만이 속성을 지원 합니다. 자세한 내용은 개별 컨트롤을 참조 하세요.
이 속성은 테마 또는 스타일시트 테마에 의해 설정될 수 없습니다. 자세한 내용은 ThemeableAttribute 하 고 ASP.NET 테마 및 스킨합니다.