RadioButton.GroupName 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定選項按鈕所屬的群組之名稱。

public:
 virtual property System::String ^ GroupName { System::String ^ get(); void set(System::String ^ value); };
public virtual string GroupName { get; set; }
[System.Web.UI.Themeable(false)]
public virtual string GroupName { get; set; }
member this.GroupName : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.GroupName : string with get, set
Public Overridable Property GroupName As String

屬性值

String

選項按鈕所屬的群組之名稱。 預設為空字串 ("")。

屬性
ThemeableAttribute

範例

下列程式碼範例說明如何以程式設計方式設定 GroupName 屬性。

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Panel Example</title>
<script language="C#" runat="server">
 
       void Button1_Click(Object sender, EventArgs e) {
          if (Radio3.GroupName == "RegularMenu") {
             Radio3.GroupName = "vegetarianMenu";
             Radio3.BackColor = System.Drawing.Color.LightGreen;
          } 
          else {
            Radio3.GroupName = "RegularMenu";
            Radio3.BackColor = System.Drawing.Color.Pink;
          }
       }    
 
    </script>
 </head>
 <body>
 
     <h3>Panel Example</h3>
 
     <form id="form1" runat="server">
 
        <asp:Label id="Label1" BackColor="Pink" Text="RegularMenu" runat="server"/>
         
 
        <asp:Label id="Label2" BackColor="LightGreen" Text="vegetarianMenu" runat="server"/>
        <br />
 
        <asp:RadioButton id="Radio1" GroupName="RegularMenu"
             Text="Beef" BackColor="Pink" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio2" GroupName="RegularMenu"
             Text="Pork" BackColor="Pink" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio3" GroupName="RegularMenu"
             Text="Fish" BackColor="Pink" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio4" GroupName="vegetarianMenu"
             Text="Mushroom" BackColor="LightGreen" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio5" GroupName="vegetarianMenu"
             Text="Tofu" BackColor="LightGreen" runat="server"/>
 
        <br />
        <asp:Button id="Button1" OnClick="Button1_Click"
             Text="Regroup the radio buttons" runat="server"/>
 
    </form>
 
 </body>
 </html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Panel Example</title>
<script language="VB" runat="server">
 
    Sub Button1_Click(sender As Object, e As EventArgs)
        If Radio3.GroupName = "RegularMenu" Then
            Radio3.GroupName = "vegetarianMenu"
            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 id="form1" runat="server">
 
        <asp:Label id="Label1" BackColor="Pink" Text="RegularMenu" runat="server"/>
         
 
        <asp:Label id="Label2" BackColor="LightGreen" Text="vegetarianMenu" runat="server"/>
        <br />
 
        <asp:RadioButton id="Radio1" GroupName="RegularMenu"
             Text="Beef" BackColor="Pink" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio2" GroupName="RegularMenu"
             Text="Pork" BackColor="Pink" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio3" GroupName="RegularMenu"
             Text="Fish" BackColor="Pink" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio4" GroupName="vegetarianMenu"
             Text="Mushroom" BackColor="LightGreen" runat="server"/>
 
        <br />
        <asp:RadioButton id="Radio5" GroupName="vegetarianMenu"
             Text="Tofu" BackColor="LightGreen" runat="server"/>
 
        <br />
        <asp:Button id="Button1" OnClick="Button1_Click"
             Text="Regroup the radio buttons" runat="server"/>
 
    </form>
 
 </body>
 </html>

備註

GroupName使用 屬性來指定選項按鈕群組，以建立互斥的控制項集。 當只有一個選項可以從可用選項清單中選取時，您可以使用 GroupName 屬性。

設定此屬性時，一次只能選取指定群組中的一個 RadioButton 。

這個屬性的值會儲存在檢視狀態中。

這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊，請參閱 ThemeableAttribute 和ASP.NET 主題和外觀。

適用於

另請參閱