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

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

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

RadioButton.GroupName プロパティ

オプションボタンが属するグループの名前を取得または設定します。

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Overridable Property
 GroupName As String

Visual Basic (使用法)

Dim instance As RadioButton
Dim value As String

value = instance.GroupName

instance.GroupName = value

[ThemeableAttribute(false)] 
public virtual string GroupName { get;
 set; }

C++

[ThemeableAttribute(false)] 
public:
virtual property String^ GroupName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_GroupName ()

/** @property */
public void set_GroupName (String value)

JScript

public function get GroupName
 () : String

public function set GroupName
 (value : String)

プロパティ値
オプションボタンが属するグループの名前。既定値は空の文字列 ("") です。

解説

GroupName プロパティを使用して、オプションボタンのグループを指定し、同時に選択できない複数のコントロールのセットを作成します。GroupName プロパティは、利用できるオプションのリストから項目を 1 つだけ選択できる場合に使用します。

このプロパティを設定した場合は、一度に選択できるのは、指定されたグループの 1 つの RadioButton だけです。

このプロパティの値はビューステートに格納されます。

このプロパティは、テーマまたはスタイルシートテーマによって設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要の各トピックを参照してください。

Topic	Location
方法 : Web フォームページに RadioButton Web サーバーコントロールを追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : 各 RadioButton Web サーバーコントロールを Web フォームページに追加する	ASP .NET Web アプリケーションの作成

使用例

GroupName プロパティをプログラムによって設定する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>
<html>
 <head>
    <script language="VB" runat="server">
 
    Sub Button1_Click(sender As Object,
 e As EventArgs)
        If Radio3.GroupName = "RegularMenu"
 Then
            Radio3.GroupName = "VegitarianMenu"
            Radio3.BackColor = System.Drawing.Color.LightGreen
        Else
            Radio3.GroupName = "RegularMenu"
            Radio3.BackColor = System.Drawing.Color.Pink
        End If
    End Sub
 
    </script>
 </head>
 <body>
 
     <h3>Panel Example</h3>
 
     <form runat=server>
 
        <asp:Label id="Label1" BackColor="Pink"
 Text="RegularMenu" runat="server"/>
        &nbsp;
 
        <asp:Label id="Label2" BackColor="LightGreen"
 Text="VegitarianMenu" runat="server"/>
        <p>
 
        <asp:RadioButton id="Radio1" GroupName="RegularMenu"
             Text="Beef" BackColor="Pink"
 runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio2" GroupName="RegularMenu"
             Text="Pork" BackColor="Pink"
 runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio3" GroupName="RegularMenu"
             Text="Fish" BackColor="Pink"
 runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio4" GroupName="VegitarianMenu"
             Text="Mushroom" BackColor="LightGreen"
 runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio5" GroupName="VegitarianMenu"
             Text="Tofu" BackColor="LightGreen"
 runat="server"/>
 
        <p>
        <asp:Button id="Button1" OnClick="Button1_Click"
             Text="Regroup the radio buttons" runat="server"/>
 
    </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
    <script language="C#" runat="server">
 
       void Button1_Click(Object sender, EventArgs e) {
          if (Radio3.GroupName == "RegularMenu") {
             Radio3.GroupName = "VegitarianMenu";
             Radio3.BackColor = System.Drawing.Color.LightGreen;
          } 
          else {
            Radio3.GroupName = "RegularMenu";
            Radio3.BackColor = System.Drawing.Color.Pink;
          }
       }    
 
    </script>
 </head>
 <body>
 
     <h3>Panel Example</h3>
 
     <form runat=server>
 
        <asp:Label id="Label1" BackColor="Pink" Text="RegularMenu"
 runat="server"/>
        &nbsp;
 
        <asp:Label id="Label2" BackColor="LightGreen" Text="VegitarianMenu"
 runat="server"/>
        <p>
 
        <asp:RadioButton id="Radio1" GroupName="RegularMenu"
             Text="Beef" BackColor="Pink" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio2" GroupName="RegularMenu"
             Text="Pork" BackColor="Pink" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio3" GroupName="RegularMenu"
             Text="Fish" BackColor="Pink" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio4" GroupName="VegitarianMenu"
             Text="Mushroom" BackColor="LightGreen" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio5" GroupName="VegitarianMenu"
             Text="Tofu" BackColor="LightGreen" runat="server"/>
 
        <p>
        <asp:Button id="Button1" OnClick="Button1_Click"
             Text="Regroup the radio buttons" runat="server"/>
 
    </form>
 
 </body>
 </html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
 <head>
    <script language="JScript" runat="server">
 
       function Button1_Click(sender, e : EventArgs) {
          if (Radio3.GroupName == "RegularMenu") {
             Radio3.GroupName = "VegitarianMenu";
             Radio3.BackColor = System.Drawing.Color.LightGreen;
          } 
          else {
            Radio3.GroupName = "RegularMenu";
            Radio3.BackColor = System.Drawing.Color.Pink;
          }
       }    
 
    </script>
 </head>
 <body>
 
     <h3>Panel Example</h3>
 
     <form runat=server>
 
        <asp:Label id="Label1" BackColor="Pink" Text="RegularMenu"
 runat="server"/>
        &nbsp;
 
        <asp:Label id="Label2" BackColor="LightGreen" Text="VegitarianMenu"
 runat="server"/>
        <p>
 
        <asp:RadioButton id="Radio1" GroupName="RegularMenu"
             Text="Beef" BackColor="Pink" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio2" GroupName="RegularMenu"
             Text="Pork" BackColor="Pink" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio3" GroupName="RegularMenu"
             Text="Fish" BackColor="Pink" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio4" GroupName="VegitarianMenu"
             Text="Mushroom" BackColor="LightGreen" runat="server"/>
 
        <p>
        <asp:RadioButton id="Radio5" GroupName="VegitarianMenu"
             Text="Tofu" BackColor="LightGreen" runat="server"/>
 
        <p>
        <asp:Button id="Button1" OnClick="Button1_Click"
             Text="Regroup the radio buttons" runat="server"/>
 
    </form>
 
 </body>
 </html>