Button.ValidationGroup Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví skupinu ovládacích prvků, pro které Button ovládací prvek způsobí ověření při odeslání zpět na server.
public:
virtual property System::String ^ ValidationGroup { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string ValidationGroup { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.ValidationGroup : string with get, set
Public Overridable Property ValidationGroup As String
Hodnota vlastnosti
Skupina ovládacích prvků, pro které Button ovládací prvek způsobí ověření, když se publikuje zpět na server. Výchozí hodnota je prázdný řetězec ("").
Implementuje
- Atributy
Příklady
Následující příklad kódu ukazuje, jak použít ValidationGroup vlastnost k určení ovládacích prvků k ověření, když Button ovládací prvek publikuje zpět na server. Stránka obsahuje tři textová pole pro zachycení dat od uživatele a tří RequiredFieldValidator ovládacích prvků, které zajistí, že uživatel nezanechá textové pole prázdné. Ovládací RequiredFieldValidator prvky pro první dvě textová pole jsou ve PersonalInfoGroup
skupině ověření a RequiredFieldValidator ovládací prvek třetího textového pole je ve LocationInfoGroup
skupině ověření. Po Button1
kliknutí se ověřují pouze ovládací prvky ve skupině PersonalInfoGroup
ověření. Po Button2
kliknutí se ověří pouze ovládací prvek ve skupině LocationInfoGroup
ověření.
Důležité
V tomto příkladu je textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.
<%@ page language="C#" %>
<!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 id="head1" runat="server">
<title>Button.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.ValidationGroup Example</h3>
<asp:label id="NameLabel"
text="Enter your name:"
runat="Server"
AssociatedControlID="NameTextBox">
</asp:label>
<asp:textbox id="NameTextBox"
runat="Server">
</asp:textbox>
<asp:requiredfieldvalidator id="RequiredFieldValidator1"
controltovalidate="NameTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="AgeLabel"
text="Enter your age:"
runat="Server"
AssociatedControlID="AgeTextBox">
</asp:label>
<asp:textbox id="AgeTextBox"
runat="Server">
</asp:textbox>
<asp:requiredfieldvalidator id="RequiredFieldValidator2"
controltovalidate="AgeTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your age."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When Button1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:button id="Button1"
text="Validate"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server" />
<br /><br />
<asp:label id="CityLabel"
text="Enter your city of residence:"
runat="Server"
AssociatedControlID="CityTextBox">
</asp:label>
<asp:textbox id="CityTextBox"
runat="Server">
</asp:textbox>
<asp:requiredfieldvalidator id="RequiredFieldValidator3"
controltovalidate="CityTextBox"
validationgroup="LocationInfoGroup"
errormessage="Enter a city name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When Button2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:button id="Button2"
text="Validate"
causesvalidation="true"
validationgroup="LocationInfoGroup"
runat="Server" />
</form>
</body>
</html>
<%@ page language="VB" %>
<!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 runat="server">
<title>Button.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.ValidationGroup Example</h3>
<asp:label id="NameLabel"
text="Enter your name:"
runat="Server"
AssociatedControlID="NameTextBox">
</asp:label>
<asp:textbox id="NameTextBox"
runat="Server">
</asp:textbox>
<asp:requiredfieldvalidator id="RequiredFieldValidator1"
controltovalidate="NameTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="AgeLabel"
text="Enter your age:"
runat="Server"
AssociatedControlID="AgeTextbox">
</asp:label>
<asp:textbox id="AgeTextbox"
runat="Server">
</asp:textbox>
<asp:requiredfieldvalidator id="RequiredFieldValidator2"
controltovalidate="AgeTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your age."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When Button1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:button id="Button1"
text="Validate"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server" />
<br /><br />
<asp:label id="CityLabel"
text="Enter your city of residence:"
runat="Server"
AssociatedControlID="CityTextbox">
</asp:label>
<asp:textbox id="CityTextbox"
runat="Server">
</asp:textbox>
<asp:requiredfieldvalidator id="RequiredFieldValidator3"
controltovalidate="CityTextBox"
validationgroup="LocationInfoGroup"
errormessage="Enter a city name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When Button2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:button id="Button2"
text="Validate"
causesvalidation="true"
validationgroup="LocationInfoGroup"
runat="Server" />
</form>
</body>
</html>
Poznámky
Skupiny ověřování umožňují přiřadit ověřovací ovládací prvky na stránce ke konkrétní kategorii. Každá ověřovací skupina se dá ověřit nezávisle na ostatních skupinách ověření na stránce. ValidationGroup Pomocí vlastnosti zadejte název ověřovací skupiny, pro kterou Button ovládací prvek způsobí ověření, když se publikuje zpět na server.
Tato vlastnost má účinek pouze v případě, že je hodnota CausesValidation vlastnosti nastavena na true
. Když zadáte hodnotu vlastnosti ValidationGroup , ověřují se při Button vrácení ovládacích prvků zpět na server pouze ověřovací ovládací prvky, které jsou součástí zadané skupiny. Pokud nezadáte hodnotu pro tuto vlastnost a CausesValidation vlastnost je nastavena na true
, všechny ověřovací ovládací prvky na stránce, které nejsou přiřazeny k ověřovací skupině, jsou ověřeny, když ovládací prvek publikuje zpět na server.
Tuto vlastnost nelze nastavit motivy ani motivy šablon stylů. Další informace najdete v tématech ThemeableAttribute a skinech a ASP.NET.