LinkButton.ValidationGroup Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia grupę kontrolek, dla których kontrolka LinkButton powoduje walidację po wysłaniu z powrotem do serwera.
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
Wartość właściwości
Grupa kontrolek, dla których kontrolka LinkButton powoduje walidację po powrocie do serwera. Wartością domyślną jest ciąg pusty ("").
Implementuje
- Atrybuty
Przykłady
W poniższym przykładzie kodu pokazano, jak za pomocą ValidationGroup właściwości określić kontrolki, które mają zostać zweryfikowane, gdy kontrolka LinkButton publikuje z powrotem na serwerze. Strona zawiera trzy pola tekstowe do przechwytywania danych od użytkownika i trzech RequiredFieldValidator kontrolek w celu zapewnienia, że użytkownik nie pozostawi pustego pola tekstowego. Kontrolki RequiredFieldValidator dla pierwszych dwóch pól tekstowych znajdują się w PersonalInfoGroup
grupie weryfikacji, a kontrolka RequiredFieldValidator trzeciego pola tekstowego znajduje się LocationInfoGroup
w grupie walidacji. Po LinkButton1
kliknięciu są weryfikowane tylko kontrolki w grupie PersonalInfoGroup
weryfikacji. Po LinkButton2
kliknięciu zostanie zweryfikowana tylko kontrolka w grupie LocationInfoGroup
sprawdzania poprawności.
Ważne
Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).
<%@ 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>LinkButton.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton.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 LinkButton1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton1"
text="Validate"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server">
</asp:linkbutton>
<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 LinkButton2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton2"
text="Validate"
causesvalidation="true"
validationgroup="LocationInfoGroup"
runat="Server">
</asp:linkbutton>
</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 id="head1" runat="server">
<title>LinkButton.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton.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 LinkButton1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton1"
text="Validate"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server">
</asp:linkbutton>
<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 LinkButton2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton2"
text="Validate"
causesvalidation="true"
validationgroup="LocationInfoGroup"
runat="Server">
</asp:linkbutton>
</form>
</body>
</html>
Uwagi
Grupy weryfikacji umożliwiają przypisywanie kontrolek walidacji na stronie do określonej kategorii. Każdą grupę weryfikacji można zweryfikować niezależnie od innych grup weryfikacji na stronie. ValidationGroup Użyj właściwości , aby określić nazwę grupy sprawdzania poprawności, dla której LinkButton kontrolka powoduje walidację po opublikowaniu z powrotem na serwerze.
Ta właściwość ma wpływ tylko wtedy, gdy wartość CausesValidation właściwości jest ustawiona na true
wartość . Po określeniu ValidationGroup wartości dla właściwości tylko kontrolki sprawdzania poprawności, które są częścią określonej grupy, są weryfikowane, gdy kontrolka LinkButton publikuje z powrotem na serwerze. Jeśli nie określisz wartości dla tej właściwości i CausesValidation właściwość zostanie ustawiona na true
wartość , wszystkie kontrolki walidacji na stronie, które nie są przypisane do grupy sprawdzania poprawności, zostaną zweryfikowane, gdy kontrolka publikuje z powrotem na serwerze.
Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttribute tematy i ASP.NET motywy i skórki.