RadioButton.GroupName Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta il nome del gruppo cui appartiene il pulsante di opzione.

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

Valore della proprietà

String

Nome del gruppo cui appartiene il pulsante di opzione. Il valore predefinito è una stringa vuota ("").

Attributi
ThemeableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la GroupName proprietà a livello di codice.

<%@ 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>

Commenti

Utilizzare la GroupName proprietà per specificare un raggruppamento di pulsanti di opzione per creare un set di controlli che si escludono a vicenda. È possibile utilizzare la GroupName proprietà quando è possibile una sola selezione da un elenco di opzioni disponibili.

Quando questa proprietà è impostata, è possibile selezionare una sola RadioButton proprietà nel gruppo specificato alla volta.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Vedi anche