CheckBoxList クラスとは何？わかりやすく解説 Weblio辞書

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

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

CheckBoxList クラス

コントロールをデータソースに連結することによって動的に作成できる複数選択チェックボックスグループを作成します。

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

Visual Basic (宣言)

Public Class CheckBoxList
    Inherits ListControl
    Implements IRepeatInfoUser, INamingContainer, IPostBackDataHandler

Visual Basic (使用法)

Dim instance As CheckBoxList

public class CheckBoxList : ListControl, IRepeatInfoUser,
 INamingContainer, IPostBackDataHandler

C++

public ref class CheckBoxList : public
 ListControl, IRepeatInfoUser, INamingContainer, IPostBackDataHandler

public class CheckBoxList extends ListControl
 implements IRepeatInfoUser, INamingContainer, 
    IPostBackDataHandler

JScript

public class CheckBoxList extends
 ListControl implements IRepeatInfoUser, INamingContainer, 
    IPostBackDataHandler

解説

CheckBoxList コントロールを使用すると、データ連結によって動的に生成できる複数選択チェックボックスグループを利用できます。これには、リストのそれぞれの項目に対応するメンバを持つ Items コレクションが含まれます。どの項目がチェックされているかを判断するには、そのコレクションを反復処理してリストの各項目の Selected プロパティをテストします。

リストの表示方法は RepeatLayout プロパティおよび RepeatDirection プロパティで指定できます。RepeatLayout を RepeatLayout.Table (既定の設定) に設定した場合、リストはテーブル内に表示されます。RepeatLayout.Flow に設定した場合、リストはテーブル構造なしで表示されます。既定では、RepeatDirection は RepeatDirection.Vertical に設定されます。このプロパティを RepeatDirection.Horizontal に設定すると、リストは水平に表示されます。

CheckBoxList コントロールには、便利なデータ連結機能が用意されています。それぞれの CheckBox コントロールには強力なレイアウト制御機能が用意されています。

注意
このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアントスクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検証してください。入力テキストをコントロールに表示する前に、検証コントロールを使用してユーザー入力を検証できます。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトおよび HTML をブロックできます。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。

注意

このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアントスクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検証してください。入力テキストをコントロールに表示する前に、検証コントロールを使用してユーザー入力を検証できます。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトおよび HTML をブロックできます。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。

ユーザー補助

このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。

Topic	Location
チュートリアル : Visual Web Developer での ASP.NET マスタページの作成と使用	Visual Studio での ASP .NET Web アプリケーションの作成
チュートリアル : カスタムビジネスオブジェクトへのデータバインディング	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : CheckBoxList Web サーバーコントロールにレイアウトを設定する	ASP .NET Web アプリケーションの作成
方法 : Web フォームページに CheckBox Web サーバーコントロールを追加する	ASP .NET Web アプリケーションの作成
方法 : Web フォームページに CheckBox Web サーバーコントロールを追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : Web フォームページに CheckBoxList Web サーバーコントロールを追加する	ASP .NET Web アプリケーションの作成
方法 : Web フォームページに CheckBoxList Web サーバーコントロールを追加する	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : データソースのデータをリスト Web サーバーコントロールに読み込む	ASP .NET Web アプリケーションの作成
方法 : データソースの項目をリスト Web サーバーコントロールに読み込む (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールでの変更に応答する	ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールに項目を追加する	ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールに項目を追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールの選択項目を確認する	ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールの選択項目を設定する	ASP .NET Web アプリケーションの作成
方法 : リスト Web サーバーコントロールの選択項目を設定する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

Web ページに CheckBoxList コントロールを作成する方法のコード例を次に示します。

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

メモ

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

Visual Basic

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

<html>

<head>

   <script runat="server">

      Sub Check_Clicked(sender as Object,
 e As EventArgs) 

         Message.Text = "Selected Item(s):<br><br>"

         ' Iterate through the Items collection of the CheckBoxList
         ' control and display the selected items.
         Dim i As Integer

         For i=0 To checkboxlist1.Items.Count
 - 1

            If checkboxlist1.Items(i).Selected Then

               Message.Text &= checkboxlist1.Items(i).Text & "<br>"

            End If

         Next

      End Sub

   </script>
 
</head>

<body>
   
   <form runat="server">
 
      <h3> CheckBoxList Example </h3>

      Select items from the CheckBoxList.

      <br><br>

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           runat="server">
 
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
 
      </asp:CheckBoxList>
 
      <br><br>

      <asp:label id="Message" runat="server"/>
             
   </form>
          
</body>

</html>

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

<html>

<head>

   <script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {

         Message.Text = "Selected Item(s):<br><br>";

         // Iterate through the Items collection of the CheckBoxList
 
         // control and display the selected items.
         for (int i=0; i<checkboxlist1.Items.Count;
 i++)
         {

            if (checkboxlist1.Items[i].Selected)
            {

               Message.Text += checkboxlist1.Items[i].Text + "<br>";

            }

         }

      }

   </script>
 
</head>

<body>
   
   <form runat="server">
 
      <h3> CheckBoxList Example </h3>

      Select items from the CheckBoxList.

      <br><br>

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           runat="server">
 
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
 
      </asp:CheckBoxList>
 
      <br><br>

      <asp:label id="Message" runat="server"/>
             
   </form>
          
</body>

</html>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.BaseDataBoundControl
         System.Web.UI.WebControls.DataBoundControl
           System.Web.UI.WebControls.ListControl
            System.Web.UI.WebControls.CheckBoxList

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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