WebControl.Enabled プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文<BindableAttribute(True)> _ <ThemeableAttribute(False)> _ Public Overridable Property Enabled As Boolean
[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)
コントロールを有効にする場合は true。それ以外の場合は false。既定値は true です。
解説Enabled プロパティを使用して、コントロールを機能させるかどうかを指定または確認します。このプロパティを false に設定すると、コントロールは淡色表示になり、コントロールには入力できなくなります。
.gif) メモ |
|---|
| このプロパティをサポートしないブラウザもあります。コントロールを淡色表示にしてロックする機能は、Microsoft Internet Explorer Version 4 以降と互換性のあるブラウザでのみ動作します。 |
このプロパティは、コントロールの階層構造の下位層にも反映されます。このため、コンテナ コントロールを無効にすると、そのコンテナ内のすべての子コントロールも無効になります。
| メモ |
|---|
| カスタムの複合コントロールを作成する際、子コントロールが作成されていないコントロールにはこの動作は適用されません。子コントロールの作成時に子コントロールの有効状態を設定するか、Enabled プロパティをオーバーライドして EnsureChildControls メソッドを呼び出す必要があります。 |
このプロパティをサポートしないコントロールもあります。詳細については、個々のコントロールのトピックを参照してください。
このプロパティを、テーマまたはスタイル シート テーマを使用して設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。
使用例Enabled プロパティをプログラムによって設定して、WebControl 基本クラスから継承した、TextBox コントロールを有効または無効にする方法の例を次に示します。
| メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ 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>
<%@ 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>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からWebControl.Enabled プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からWebControl.Enabled プロパティ
を検索
- WebControl.Enabled プロパティのページへのリンク
