WebControl.Enabled 속성

정의

웹 서버 컨트롤이 활성화되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the Web server control is enabled.

public:
 virtual property bool Enabled { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public virtual bool Enabled { get; set; }
member this.Enabled : bool with get, set
Public Overridable Property Enabled As Boolean

속성 값

컨트롤이 활성화되면 true이고, 그렇지 않으면 false입니다.true if control is enabled; otherwise, false. 기본값은 true입니다.The default is true.

특성

예제

다음 예제를 사용 하도록 설정 하 고 사용 하지 않도록 설정 하는 방법을 TextBox 컨트롤에서 상속 합니다 WebControl 설정 하 여 기본 클래스 해당 Enabled 속성 프로그래밍 방식으로 합니다.The following example illustrates how to enable and disable a TextBox control, inherited from the WebControl base class, by setting its Enabled property programmatically.

참고

다음 코드 샘플 단일 파일 코드 모델을 사용 하 고 코드 숨김 파일에 직접 복사 하는 경우 제대로 작동 하지 않을 수 있습니다.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. 이 코드 샘플.aspx 확장명이 있는 빈 텍스트 파일에 복사 해야 합니다.This code sample must be copied into an empty text file that has an .aspx extension. Web Forms 코드 모델에 대 한 자세한 내용은 참조 하세요. ASP.NET Web Forms 페이지 코드 모델합니다.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

중요

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다.This example has a text box that accepts user input, which is a potential security threat. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 자세한 내용은 Script Exploits Overview를 참조하세요.For more information, see 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, 컨트롤 일반적으로 흐리게 표시 합니다.When the Enabled property of a control is set to false, the control typically appears dimmed. Input 요소를 컨트롤을 사용 하는 경우 브라우저는 사용자가 클릭 하거나 해당 입력을 방지 합니다.If the control is an input element, the browser prevents the user from clicking or typing in it. 서버 컨트롤에 렌더링 되는 HTML 요소를 설정 하 여 비활성화 된 것으로 표시 된 해당 disabled 특성 또는 해당 CSS class 특성입니다.HTML elements that are rendered for a server control are marked as disabled by setting their disabled attribute or their CSS class attribute. 자세한 내용은 SupportsDisabledAttributeControlRenderingCompatibilityVersion를 참조하세요.For more information, see SupportsDisabledAttribute and ControlRenderingCompatibilityVersion.

이 속성은 컨트롤 계층 구조 아래로 전파합니다.This property propagates down the control hierarchy. 컨테이너 컨트롤을 비활성화 하면 해당 컨테이너 내의 자식 컨트롤 조건도 비활성화 됩니다.If you disable a container control, the child controls within that container are also disabled. 자세한 내용은 IsEnabled 속성을 참조하세요.For more information, see the IsEnabled property.

참고

사용자 지정 복합 컨트롤에서 상속 동작은이 컨트롤을 아직 만들지 않은 해당 자식 컨트롤에 적용 되지 않습니다.In a custom composite control, this inheritance behavior does not apply to controls that have not yet created their child controls. 설정 해야 설정 된 상태의 자식 컨트롤을 만들어야 하는지 또는 재정의 하는 경우는 Enabled 속성을 호출 합니다 EnsureChildControls 메서드.You must either set the enabled state of the child controls when they are created, or override the Enabled property to call the EnsureChildControls method.

참고

컨트롤을 사용 하지 않도록 설정 브라우저 UI 통해 사용자가 컨트롤과 상호 작용만 제한 됩니다.Disabling a control only prevents interaction with the control by the user through the browser UI. 사용자 페이지의 컨트롤을 사용할 경우에 페이지에 의해 처리 되는 포스트백 전송 하는 요청을 만들 수는 것이 가능 합니다.It is possible for a user to craft a request that submits a postback that is processed by the page even if controls on the page are disabled. 포스트백 요청을 처리 하기 전에 컨트롤을 사용 하도록 설정 하 고 볼 수 있는지 확인 합니다.Before you process a postback request, check to make sure that the control is enabled and visible.

없거나 일부 컨트롤만이 속성을 지원 합니다.Not all controls support this property. 자세한 내용은 개별 컨트롤을 참조 하세요.See the individual controls for details.

이 속성은 테마 또는 스타일시트 테마에 의해 설정될 수 없습니다.This property cannot be set by themes or style sheet themes. 자세한 내용은 ThemeableAttribute 하 고 ASP.NET 테마 및 스킨합니다.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

적용 대상

추가 정보