RadioButton.GroupName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя группы, к которой принадлежит переключатель.
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
Значение свойства
Имя группы, к которой принадлежит переключатель. Значение по умолчанию — пустая строка ("").
- Атрибуты
Примеры
В следующем примере кода показано, как задать 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 темы и обложки.