WebControl.Enabled プロパティ

  • [アーティクル]

Web サーバー コントロールを有効にするかどうかを示す値を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)

構文

'宣言
<BindableAttribute(True)> _
<ThemeableAttribute(False)> _
Public Overridable Property Enabled As Boolean
'使用
Dim instance As WebControl
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

[BindableAttribute(true)] 
[ThemeableAttribute(false)] 
public virtual bool Enabled { get; set; }

[BindableAttribute(true)] 
[ThemeableAttribute(false)] 
public:
virtual property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled ()

/** @property */
public void set_Enabled (boolean value)

public function get Enabled () : boolean

public function set Enabled (value : boolean)

適用できません。

プロパティ値

コントロールを有効にする場合は true。それ以外の場合は false。既定値は true です。

解説

Enabled プロパティを使用して、コントロールを機能させるかどうかを指定または確認します。このプロパティを false に設定すると、コントロールは淡色表示になり、コントロールには入力できなくなります。

メモメモ :

このプロパティをサポートしないブラウザもあります。コントロールを淡色表示にしてロックする機能は、Microsoft Internet Explorer Version 4 以降と互換性のあるブラウザでのみ動作します。

このプロパティは、コントロールの階層構造の下位層にも反映されます。このため、コンテナ コントロールを無効にすると、そのコンテナ内のすべての子コントロールも無効になります。

メモメモ :

カスタムの複合コントロールでは、子コントロールが作成されていないコントロールにこの動作は適用されません。子コントロールの作成時に子コントロールの有効状態を設定するか、Enabled プロパティをオーバーライドして EnsureChildControls メソッドを呼び出す必要があります。
メモメモ :

無効になっているコントロールでも、ポストバックがサポートされます。無効なコントロールを含むページを表示しているユーザーは、そのページで処理されるポストバックを送信する要求を作成できます。ポストバック要求を処理する前に、コントロールが有効となっており、表示されていることを確認してください。

このプロパティをサポートしないコントロールもあります。詳細については、個々のコントロールのトピックを参照してください。

このプロパティを、テーマまたはスタイル シート テーマを使用して設定することはできません。詳細については、ThemeableAttribute のトピックおよび「ASP.NET のテーマとスキンの概要」を参照してください。

トピック 場所
チュートリアル : Web フォーム ページにおけるユーザーの入力の検証 Visual Studio での ASP .NET Web アプリケーションの作成
チュートリアル : Web フォーム ページにおけるユーザーの入力の検証 Visual Web Developer でのアプリケーションの作成

使用例

Enabled プロパティをプログラムによって設定して、WebControl 基本クラスから継承した、TextBox コントロールを有効または無効にする方法の例を次に示します。

メモメモ :

次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。
セキュリティに関するメモセキュリティに関するメモ :

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは 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>

<%@ 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="JScript" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 
    function SubmitBtn1_Click(sender : Object, e : EventArgs)
    {
        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>

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

WebControl クラス
WebControl メンバ
System.Web.UI.WebControls 名前空間
EnsureChildControls

その他の技術情報

ASP.NET Web サーバー コントロールとブラウザの機能
Web サーバー コントロール構文
ASP.NET カスタム サーバー コントロールの開発