Nyelv

BaseValidator.ValidationGroup Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Lekéri vagy beállítja annak az érvényesítési csoportnak a nevét, amelyhez ez az ellenőrzési vezérlő tartozik.

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

Tulajdonság értéke

String

Annak az érvényesítési csoportnak a neve, amelyhez ez az ellenőrzési vezérlő tartozik. Az alapértelmezett érték egy üres sztring (""), amely azt jelzi, hogy ez a tulajdonság nincs beállítva.

Attribútumok
ThemeableAttribute

Példák

Az alábbi példakód bemutatja, hogyan rendelhet hozzá érvényesítési vezérlőt egy csoporthoz a ValidationGroup tulajdonság használatával.

Important

Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

<%@ 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 runat="server">
    <title>BaseValidator ValidationGroup Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>BaseValidator ValidationGroup Example</h3>
     
      Please enter your name:<br/>
      <asp:textbox id="NameTextBox" 
        runat="server"/>

      <asp:requiredfieldvalidator id="NameTextBoxRequiredValidator" 
        controltovalidate="NameTextBox"
        display="Dynamic" 
        text="Please enter your name."
        validationgroup="UserInfoGroup" 
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        validationgroup="UserInfoGroup" 
        runat="server"/>
        
      <hr/>
      
      Please enter a search topic:<br/>
      <asp:textbox id="SearchTextBox" 
        runat="server"/>

      <asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator" 
        controltovalidate="SearchTextBox"
        display="Dynamic" 
        text="Please enter a topic."
        validationgroup="SearchGroup"
        runat="server"/>

      <br /><br />

      <asp:button id="SearchButton"
        text="Search"
        validationgroup="SearchGroup"
        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>BaseValidator ValidationGroup Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>BaseValidator ValidationGroup Example</h3>
     
      Please enter your name:<br/>
      <asp:textbox id="NameTextBox" 
        runat="server"/>

      <asp:requiredfieldvalidator id="NameTextBoxRequiredValidator" 
        controltovalidate="NameTextBox"
        display="Dynamic" 
        text="Please enter your name."
        validationgroup="UserInfoGroup" 
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        validationgroup="UserInfoGroup" 
        runat="server"/>
        
      <hr/>
      
      Please enter a search topic:<br/>
      <asp:textbox id="SearchTextBox" 
        runat="server"/>

      <asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator" 
        controltovalidate="SearchTextBox"
        display="Dynamic" 
        text="Please enter a topic."
        validationgroup="SearchGroup"
        runat="server"/>

      <br /><br />

      <asp:button id="SearchButton"
        text="Search"
        validationgroup="SearchGroup"
        runat="server"/>
 
    </form>
  </body>
</html>

Megjegyzések

ASP.NET számos olyan vezérlőt biztosít, amely képes a kiszolgálóra való visszatérésre. Ha az egyik vezérlő tulajdonsága CausesValidation a következőre truevan állítva, az ellenőrzés akkor történik meg, amikor a vezérlő visszahelyez a kiszolgálóra. Az alábbi vezérlők a kiszolgálóra való visszatérésre képesek:

Note

Ezen vezérlők némelyike csak akkor kerül vissza a kiszolgálóra, ha a AutoPostBack tulajdonság értéke true.

Ezek a vezérlők rendelkeznek olyan ValidationGroup tulajdonságokkal, amelyek beállításkor csak a megadott csoportban lévő érvényesítési vezérlőket ellenőrzik, amikor a vezérlő egy bejegyzést indít vissza a kiszolgálóra. ValidationGroup A tulajdonság használatával érvényesítési vezérlőt rendelhet egy érvényesítési csoporthoz. Az Page osztály egy metódust és egy GetValidators bemeneti paramétert elfogadó metódust ValidateValidationGroup is elérhetővé tesz.

Ez a tulajdonság nem állítható be témák vagy stíluslaptémák szerint. További információ: ThemeableAttribute és ASP.NET Témák és bőrök.

A következőre érvényes:

Lásd még