ListItem.Enabled プロパティ

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

ListItem.Enabled プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

リスト項目が有効であるどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property Enabled As
 Boolean

Visual Basic (使用法)

Dim instance As ListItem
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

C#

public bool Enabled { get;
 set; }

C++

public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

J#

/** @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 プロパティでは、ListItem コントロールが有効であるか無効であるかを指定できます。無効な ListItem コントロールは淡色表示になり、選択できないことを示します。このプロパティを使用して、RadioButtonList コントロールまたは CheckBoxList コントロールの ListItem コントロールを無効にします。

メモ
このプロパティを使用して、DropDownList コントロールまたは ListBox コントロールの ListItem コントロールを無効にできます。

使用例

Enabled プロパティを使用して、RadioButtonList コントロールのリスト項目をプログラムによって無効にする方法の例を次に示します。最初の質問は、自分の職種に対応するオプション ボタンを選択するようにユーザーに要求します。開発者でないことをユーザーが示した場合は、2 番目のオプション ボタン リストのリスト項目が無効になります。2 番目の質問は、主プログラミング言語を選択するようにユーザーに要求します。この質問は開発者ではないユーザーには無関係です。

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

Visual Basic

<%@ Page Language="VB" %>

<html>
  <head>
    <script runat="server">         
  
      Sub Index_Changed(ByVal sender As
 Object, ByVal e As System.EventArgs)
        Dim i As Integer

        ' If the user is not a developer, do not
        ' ask the user to select a programming language.
        If radiobuttonlist1.SelectedIndex = 2 Then
          ' Clear any previously selected list 
          ' items in the second question.
          Radiobuttonlist2.SelectedIndex = -1

          ' Disable all the list items in the second question.
          For i = 0 To Radiobuttonlist2.Items.Count
 - 1
            Radiobuttonlist2.Items(i).Enabled = False
          Next
          
        Else
          ' Enable all the list items in the second question.
          For i = 0 To Radiobuttonlist2.Items.Count
 - 1
            Radiobuttonlist2.Items(i).Enabled = True
          Next i

        End If
      End Sub
    
      </script>
  </head>

  <body>
    <form id="Form1" runat="server">
        
      <h3>ListItem.Enabled Property Example</h3>
      
      Select your occupation:
      <asp:radiobuttonlist id="RadioButtonList1"
        autopostback=true
        onselectedindexchanged="Index_Changed" 
    runat="server">             
      <asp:ListItem>Web developer</asp:ListItem>
      <asp:ListItem>Windows developer</asp:ListItem>
      <asp:ListItem>Occupation other than developer</asp:ListItem>
        </asp:radiobuttonlist>
          
    <br /><br />
          
    Select your primary programming language:
        <asp:radiobuttonlist id="RadioButtonList2"
 
      runat="server">             
       <asp:ListItem>Visual Basic .NET</asp:ListItem>
       <asp:ListItem>C#</asp:ListItem>
       <asp:ListItem>C++</asp:ListItem>
       <asp:ListItem>Other</asp:ListItem>
    </asp:radiobuttonlist> 
                  
    </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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ListItem クラス
ListItem メンバ
System.Web.UI.WebControls 名前空間
RadioButtonList
CheckBoxList クラス
ListControl クラス
RadioButtonList
ListBox クラス
DropDownList クラス
CheckBoxList クラス
その他の技術情報
ListBox Web サーバー コントロール
RadioButton Web サーバー コントロールおよび RadioButtonList Web サーバー コントロールの概要
CheckBox Web サーバー コントロールおよび CheckBoxList Web サーバー コントロール
BulletedList Web サーバー コントロール
DropDownList Web サーバー コントロール