RadioButton.GroupName-Eigenschaft

Artikel
08/20/2007

Ruft den Namen der Gruppe ab, der das Optionsfeld angehört, oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property GroupName As String
'Usage
Dim instance As RadioButton
Dim value As String

value = instance.GroupName

instance.GroupName = value

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

[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)

public function get GroupName () : String

public function set GroupName (value : String)

Eigenschaftenwert

Der Name der Gruppe, zu der das Optionsfeld gehört. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Mit der GroupName-Eigenschaft können Sie die Gruppierung von Optionsfeldern festlegen, um eine Gruppe sich gegenseitig ausschließender Steuerelemente zu erstellen. Sie können die GroupName-Eigenschaft verwenden, wenn in einer Liste nur eine der verfügbaren Optionen ausgewählt werden kann.

Wenn diese Eigenschaft festgelegt ist, kann immer nur ein RadioButton in der angegebenen Gruppe ausgewählt werden.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Diese Eigenschaft kann nicht von Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.

Thema	Position
Gewusst wie: Hinzufügen von RadioButton-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButton-Webserversteuerelementen zu einer Web Forms-Seite	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von RadioButton-Webserversteuerelementen zu einer Web Forms-Seite	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen einzelner RadioButton-Webserversteuerelemente zu einer Web Forms-Seite	Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird das programmgesteuerte Festlegen der GroupName-Eigenschaft veranschaulicht.

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

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

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Freigeben über

RadioButton.GroupName-Eigenschaft

Syntax

Eigenschaftenwert

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen