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

.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

public bool Enabled { get;
 set; }

C++

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

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

使用例

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

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

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .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>