RadioButtonList クラス
アセンブリ: System.Web (system.web.dll 内)

<ValidationPropertyAttribute("SelectedItem")> _ Public Class RadioButtonList Inherits ListControl Implements IRepeatInfoUser, INamingContainer, IPostBackDataHandler
[ValidationPropertyAttribute("SelectedItem")] public class RadioButtonList : ListControl, IRepeatInfoUser, INamingContainer, IPostBackDataHandler
[ValidationPropertyAttribute(L"SelectedItem")] public ref class RadioButtonList : public ListControl, IRepeatInfoUser, INamingContainer, IPostBackDataHandler

RadioButtonList コントロールを使用すると、ページの開発者はデータ連結によって動的に生成できる単一選択オプション ボタン グループを利用できます。これには、リストのそれぞれの項目に対応するメンバを持つ Items コレクションが含まれます。選択項目を決定するには、リストの SelectedItem プロパティを調べます。
RepeatLayout プロパティと RepeatDirection プロパティでリストの表示方法を指定できます。RepeatLayout を RepeatLayout.Table (既定の設定) に設定した場合は、リストはテーブル内に表示されます。RepeatLayout.Flow に設定した場合は、リストはテーブル構造なしで表示されます。既定では、RepeatDirection は RepeatDirection.Vertical に設定されます。このプロパティを RepeatDirection.Horizontal に設定すると、リストは水平に表示されます。
![]() |
---|
このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアント スクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。検証コントロールを使用して、入力テキストを RadioButtonList コントロールに表示する前にユーザー入力を検証できます。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。詳細については、「標準コントロールのセキュリティ保護」、「方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する」、および「ASP.NET Web ページにおけるユーザー入力の検証」を参照してください。 |
ユーザー補助
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。

プログラムによって RadioButtonList コントロールの表示を変更する方法を次のコード例に示します。
![]() |
---|
次のコード例はシングルファイル コード モデルを使用しているため、分離コード ファイルに直接コピーすると正しく動作しない場合があります。このコード例は、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ 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>
<%@ 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>
<%@ 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>


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.RadioButtonList


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


RadioButtonList メンバ
System.Web.UI.WebControls 名前空間
ListControl クラス
RepeatDirection
RepeatLayout
その他の技術情報
RadioButton Web サーバー コントロールおよび RadioButtonList Web サーバー コントロール
標準コントロールのセキュリティ保護
Weblioに収録されているすべての辞書からRadioButtonList クラスを検索する場合は、下記のリンクをクリックしてください。

- RadioButtonList クラスのページへのリンク