WebControl.Enabled プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebControl.Enabled プロパティ

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

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

Visual Basic (宣言)

<BindableAttribute(True)> _
<ThemeableAttribute(False)> _
Public Overridable Property
 Enabled As Boolean

Visual Basic (使用法)

Dim instance As WebControl
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

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

C++

[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)

JScript

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 のテーマとスキンの概要の各トピックを参照してください。

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

使用例

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

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

メモ

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

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>

<html>
 <body>
 
     <h3>Enabled Property of a Web Control<br></h3>
 
 <script language="VB" runat="server">
 
    Sub SubmitBtn1_Click(sender As Object,
 e As EventArgs)
        TextBox1.Enabled = Not(TextBox1.Enabled)
    End Sub
 
 </script>
 
 <form runat=server>
 
     <asp:TextBox id="TextBox1" BackColor="LightBlue"
 runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightGreen"
 runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
 
     Text="Click to disable/enable the light blue text box"
 
     runat="server"/>
     <p>
     
 </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <body>
 
     <h3>Enabled Property of a Web Control<br></h3>
 
 <script language="C#" runat="server">
 
     void SubmitBtn1_Click(Object sender, EventArgs e) {
        TextBox1.Enabled = !(TextBox1.Enabled);
     }
 
 </script>
 
 <form runat=server>
 
     <asp:TextBox id="TextBox1" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightGreen" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
 
     Text="Click to disable/enable the light blue text box" 
     runat="server"/>
     <p>
     
 </form>
 
 </body>
 </html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 <body>
 
     <h3>Enabled Property of a Web Control<br></h3>
 
 <script language="JSCRIPT" runat="server">
 
    function SubmitBtn1_Click(sender : Object, e : EventArgs){
        TextBox1.Enabled = !TextBox1.Enabled
    }
 
 </script>
 
 <form runat=server>
 
     <asp:TextBox id="TextBox1" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightGreen" runat="server"/>
     <p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
 
     Text="Click to disable/enable the light blue text box" 
     runat="server"/>
     <p>
     
 </form>
 
 </body>
 </html>