RadioButton.GroupName 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置单选按钮所属的组名。
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, setPublic Overridable Property GroupName As String属性值
单选按钮所属的组名。 默认值为空字符串("")。
- 属性
示例
下面的代码示例演示如何以编程方式设置 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 主题和外观。