Button.ValidationGroup Tulajdonság

Definíció

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

Lekéri vagy beállítja azon vezérlők csoportját, amelyek esetében a Button vezérlő érvényesítést okoz, amikor a kiszolgálóra küld vissza bejegyzéseket.

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

Azon vezérlők csoportja, amelyek esetében a Button vezérlő érvényesítést okoz, amikor a kiszolgálóra való visszahelyezési művelet történik. Az alapértelmezett érték egy üres sztring ("").

Megvalósítás

ValidationGroup
Attribútumok
ThemeableAttribute

Példák

Az alábbi példakód bemutatja, hogyan használható a tulajdonság a ValidationGroup vezérlőknek a kiszolgálóra való visszatéréskor érvényesítendő Button vezérlők megadására. A lap három szövegdobozt tartalmaz a felhasználó adatainak rögzítéséhez, valamint három RequiredFieldValidator vezérlőt, hogy a felhasználó ne hagyjon üresen egy szövegdobozt. Az RequiredFieldValidator első két szövegdoboz vezérlői az PersonalInfoGroup érvényesítési csoportban, a RequiredFieldValidator harmadik szövegmező vezérlőeleme pedig az LocationInfoGroup érvényesítési csoportban található. Kattintáskor Button1 csak az érvényesítési csoport PersonalInfoGroup vezérlői lesznek érvényesítve. Ha Button2 a rendszer rákattint, csak az érvényesítési csoportban LocationInfoGroup lévő vezérlőelem lesz érvényesítve.

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 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>

Megjegyzések

Az érvényesítési csoportok lehetővé teszik, hogy egy lapon érvényesítési vezérlőket rendeljen egy adott kategóriához. Az egyes érvényesítési csoportok a lapon található többi érvényesítési csoporttól függetlenül is érvényesíthetők. ValidationGroup A tulajdonság használatával adja meg annak az érvényesítési csoportnak a nevét, amelynek ellenőrzése a Button kiszolgálóra való visszatéréskor érvényesítést okoz.

Ennek a tulajdonságnak csak akkor van hatása, ha a CausesValidation tulajdonság értéke a következőre truevan állítva: . A tulajdonság értékének ValidationGroup megadásakor csak a megadott csoporthoz tartozó érvényesítési vezérlők lesznek érvényesítve, amikor a Button vezérlő visszahelyez a kiszolgálóra. Ha nem ad meg értéket ehhez a tulajdonsághoz, és a CausesValidation tulajdonság értéke be van állítva true, a rendszer ellenőrzi a lap azon érvényesítési vezérlőinek érvényességét, amelyek nincsenek érvényesítési csoporthoz rendelve, amikor a vezérlő visszahelyez a kiszolgálóra.

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