RadioButtonList クラス

[アーティクル]
03/28/2008

オプションボタンコントロールのグループをカプセル化するリストコントロールを表します。

この型のすべてのメンバの一覧については、RadioButtonList メンバを参照してください。

System.Object
   System.Web.UI.Control
      System.Web.UI.WebControls.WebControl
         System.Web.UI.WebControls.ListControl
            System.Web.UI.WebControls.RadioButtonList

Public Class RadioButtonList
   Inherits ListControl
   Implements IRepeatInfoUser, INamingContainer, _
   IPostBackDataHandler
[C#]
public class RadioButtonList : ListControl, IRepeatInfoUser,
   INamingContainer, IPostBackDataHandler
[C++]
public __gc class RadioButtonList : public ListControl,
   IRepeatInfoUser, INamingContainer, IPostBackDataHandler
[JScript]
public class RadioButtonList extends ListControl implements
   IRepeatInfoUser, INamingContainer, IPostBackDataHandler

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

RadioButtonList コントロールを使用すると、ページの開発者はデータ連結によって動的に生成できる単一選択オプションボタングループを利用できます。これには、リストのそれぞれの項目に対応するメンバを持つ Items コレクションが含まれます。選択項目を決定するには、リストの SelectedItem プロパティを調べます。

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

注意このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアントスクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバーコントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「検証サーバーコントロール」を参照してください。

使用例

[Visual Basic, C#, JScript] プログラムによって RadioButtonList コントロールの表示を変更する方法を次の例に示します。

 
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <head>
     <script language="VB" runat="server">

    Sub Button1_Click(Source As Object, e As EventArgs)
        If RadioButtonList1.SelectedIndex > - 1 Then
            Label1.Text = "You selected: " & RadioButtonList1.SelectedItem.Text
        End If
    End Sub

    Sub chkLayout_CheckedChanged(sender As Object, e As EventArgs)        
        If chkLayout.Checked = True Then
            RadioButtonList1.RepeatLayout = RepeatLayout.Table
        Else
            RadioButtonList1.RepeatLayout = RepeatLayout.Flow
        End If
    End Sub

    Sub chkDirection_CheckedChanged(sender As Object, e As EventArgs)        
        If chkDirection.Checked = True Then
            RadioButtonList1.RepeatDirection = RepeatDirection.Horizontal
        Else
            RadioButtonList1.RepeatDirection = RepeatDirection.Vertical
        End If
    End Sub
 
     </script>
 
 </head>
 <body>
 
     <h3>RadioButtonList Example</h3>
 
     <form runat=server>
 
         <asp:RadioButtonList id=RadioButtonList1 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:RadioButtonList>
 
         <p>
         
         <asp:CheckBox id=chkLayout OnCheckedChanged="chkLayout_CheckedChanged" Text="Display Table Layout" Checked=true AutoPostBack="true" runat="server" />
 
         <br>
         
         <asp:CheckBox id=chkDirection OnCheckedChanged="chkDirection_CheckedChanged" Text="Display Horizontally" AutoPostBack="true" runat="server" />
 
         <p>
         
         <asp:Button id=Button1 Text="Submit" onclick="Button1_Click" runat="server"/>
 
         <p>
         
         <asp:Label id=Label1 font-name="Verdana" font-size="8pt" runat="server"/>
 
     </form>
 
 </body>
 </html>
   

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
     <script language="C#" runat="server">
 
        void Button1_Click(object Source, EventArgs e) 
        {
           if (RadioButtonList1.SelectedIndex > -1) 
           {  
              Label1.Text = "You selected: " + RadioButtonList1.SelectedItem.Text;
           }
        }
 
        void chkLayout_CheckedChanged(Object sender, EventArgs e) 
        {
        
           if (chkLayout.Checked == true) 
           {
              RadioButtonList1.RepeatLayout = RepeatLayout.Table;
           }
           else 
           {
              RadioButtonList1.RepeatLayout = RepeatLayout.Flow;
           }     
        }
        
        void chkDirection_CheckedChanged(Object sender, EventArgs e) 
        {
        
           if (chkDirection.Checked == true) 
           {
              RadioButtonList1.RepeatDirection = RepeatDirection.Horizontal;
           }
           else 
           {
              RadioButtonList1.RepeatDirection = RepeatDirection.Vertical;
           }  
        }
 
     </script>
 
 </head>
 <body>
 
     <h3>RadioButtonList Example</h3>
 
     <form runat=server>
 
         <asp:RadioButtonList id=RadioButtonList1 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:RadioButtonList>
 
         <p>
         
         <asp:CheckBox id=chkLayout OnCheckedChanged="chkLayout_CheckedChanged" Text="Display Table Layout" Checked=true AutoPostBack="true" runat="server" />
 
         <br>
         
         <asp:CheckBox id=chkDirection OnCheckedChanged="chkDirection_CheckedChanged" Text="Display Horizontally" AutoPostBack="true" runat="server" />
 
         <p>
         
         <asp:Button id=Button1 Text="Submit" onclick="Button1_Click" runat="server"/>
 
         <p>
         
         <asp:Label id=Label1 font-name="Verdana" font-size="8pt" runat="server"/>
 
     </form>
 
 </body>
 </html>
   

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
 <head>
     <script language="JScript" runat="server">
 
        function Button1_Click(Source : System.Object, e : EventArgs) 
        {
           if (RadioButtonList1.SelectedIndex > -1) 
           {  
              Label1.Text = "You selected: " + RadioButtonList1.SelectedItem.Text;
           }
        }
 
        function chkLayout_CheckedChanged(sender : System.Object, e : EventArgs) 
        {
        
           if (chkLayout.Checked == true) 
           {
              RadioButtonList1.RepeatLayout = RepeatLayout.Table;
           }
           else 
           {
              RadioButtonList1.RepeatLayout = RepeatLayout.Flow;
           }     
        }
        
        function chkDirection_CheckedChanged(sender : System.Object, e : EventArgs) 
        {
        
           if (chkDirection.Checked == true) 
           {
              RadioButtonList1.RepeatDirection = RepeatDirection.Horizontal;
           }
           else 
           {
              RadioButtonList1.RepeatDirection = RepeatDirection.Vertical;
           }  
        }
 
     </script>
 
 </head>
 <body>
 
     <h3>RadioButtonList Example</h3>
 
     <form runat=server>
 
         <asp:RadioButtonList id=RadioButtonList1 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:RadioButtonList>
 
         <p>
         
         <asp:CheckBox id=chkLayout OnCheckedChanged="chkLayout_CheckedChanged" Text="Display Table Layout" Checked=true AutoPostBack="true" runat="server" />
 
         <br>
         
         <asp:CheckBox id=chkDirection OnCheckedChanged="chkDirection_CheckedChanged" Text="Display Horizontally" AutoPostBack="true" runat="server" />
 
         <p>
         
         <asp:Button id=Button1 Text="Submit" onclick="Button1_Click" runat="server"/>
 
         <p>
         
         <asp:Label id=Label1 font-name="Verdana" font-size="8pt" runat="server"/>
 
     </form>
 
 </body>
 </html>

[C++] C++ のサンプルはありません。Visual Basic、C#、および JScript のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Web.UI.WebControls

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Web (System.Web.dll 内)

参照

RadioButtonList メンバ | System.Web.UI.WebControls 名前空間 | ListControl | RepeatDirection | RepeatLayout

次の方法で共有

RadioButtonList クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース