ImageButton.ValidationGroup Eigenschaft

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dient zum Abrufen oder Festlegen der Gruppe von Steuerelementen, für die das ImageButton Steuerelement eine Überprüfung verursacht, wenn es wieder auf dem Server veröffentlicht wird.

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

Eigenschaftswert

String

Die Gruppe der Steuerelemente, für die das ImageButton Steuerelement eine Überprüfung bewirkt, wenn es wieder auf dem Server veröffentlicht wird. Der Standardwert ist eine leere Zeichenfolge ("").

Implementiert

ValidationGroup

Attribute: ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ValidationGroup Eigenschaft verwendet wird, um die Steuerelemente anzugeben, die überprüft werden sollen, wenn ein ImageButton Steuerelement wieder auf dem Server bereitgestellt wird. Die Seite enthält drei Textfelder zum Erfassen von Daten des Benutzers und drei RequiredFieldValidator Steuerelemente, um sicherzustellen, dass der Benutzer kein Textfeld leer lässt. Die RequiredFieldValidator Steuerelemente für die ersten beiden Textfelder befinden sich in der PersonalInfoGroup Überprüfungsgruppe, und das RequiredFieldValidator Steuerelement für das dritte Textfeld befindet sich in der LocationInfoGroup Überprüfungsgruppe. Wenn ImageButton1 auf diese Option geklickt wird, werden nur die Steuerelemente in der Überprüfungsgruppe PersonalInfoGroup überprüft. Wenn ImageButton2 sie geklickt wird, wird nur das Steuerelement in der Überprüfungsgruppe LocationInfoGroup überprüft.

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

    <asp:label id="NameLabel" 
      text="Enter your name:"
      runat="Server"
      AssociatedControlID="NameTextBox">
    </asp:label>

    &nbsp
    
    <asp:textbox id="NameTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp

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

    &nbsp
    
    <asp:textbox id="AgeTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp

    <asp:requiredfieldvalidator id="RequiredFieldValidator2"
      controltovalidate="AgeTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your age."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When ImageButton1 is clicked, only validation
    controls that are a part of PersonalInfoGroup
    are validated.-->
    <asp:imagebutton id="ImageButton1" 
      alternatetext="Validate PersonalInfoGroup controls" 
      imageurl="Images/ImageButton1.JPG"
      causesvalidation="true"
      validationgroup="PersonalInfoGroup"
      runat="Server" />
      
    <br /><br />
      
    <asp:label id="CityLabel" 
      text="Enter your city of residence:"
      runat="Server"
      AssociatedControlID="CityTextBox">
    </asp:label>

    &nbsp
    
    <asp:textbox id="CityTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp

    <asp:requiredfieldvalidator id="RequiredFieldValidator3"
      controltovalidate="CityTextBox"
      validationgroup="LocationInfoGroup"
      errormessage="Enter a city name."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When ImageButton2 is clicked, only validation
    controls that are a part of LocationInfoGroup
    are validated.-->
    <asp:imagebutton id="ImageButton2" 
      alternatetext="Validate LocationInfoGroup controls" 
      imageUrl="Images/ImageButton2.JPG"
      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 id="head1" runat="server">
  <title>ImageButton.ValidationGroup Example</title>
</head>
<body>
  <form id="form1" runat="server">
  
    <h3>ImageButton.ValidationGroup Example</h3>

    <asp:label id="NameLabel" 
      text="Enter your name:"
      runat="Server" AssociatedControlID="NameTextBox">
    </asp:label>

    &nbsp
    
    <asp:textbox id="NameTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp

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

    &nbsp
    
    <asp:textbox id="AgeTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp

    <asp:requiredfieldvalidator id="RequiredFieldValidator2"
      controltovalidate="AgeTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your age."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When ImageButton1 is clicked, only validation
    controls that are a part of PersonalInfoGroup
    are validated.-->
    <asp:imagebutton id="ImageButton1" 
      alternatetext="Validate PersonalInfoGroup controls" 
      imageurl="Images/ImageButton1.JPG"
      causesvalidation="true"
      validationgroup="PersonalInfoGroup"
      runat="Server" />
      
    <br /><br />
      
    <asp:label id="CityLabel" 
      text="Enter your city of residence:"
      runat="Server"
      AssociatedControlID="CityTextBox">
    </asp:label>

    &nbsp
    
    <asp:textbox id="CityTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp

    <asp:requiredfieldvalidator id="RequiredFieldValidator3"
      controltovalidate="CityTextBox"
      validationgroup="LocationInfoGroup"
      errormessage="Enter a city name."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When ImageButton2 is clicked, only validation
    controls that are a part of LocationInfoGroup
    are validated.-->
    <asp:imagebutton id="ImageButton2" 
      alternatetext="Validate LocationInfoGroup controls" 
      imageUrl="Images/ImageButton2.JPG"
      causesvalidation="true"
      validationgroup="LocationInfoGroup"
      runat="Server" />

  </form>
</body>
</html>

Hinweise

Mithilfe von Validierungsgruppen können Sie einer bestimmten Kategorie Überprüfungssteuerelemente auf einer Seite zuweisen. Jede Überprüfungsgruppe kann unabhängig von anderen Validierungsgruppen auf der Seite überprüft werden. Verwenden Sie die ValidationGroup Eigenschaft, um den Namen der Überprüfungsgruppe anzugeben, für die das ImageButton Steuerelement eine Überprüfung verursacht, wenn sie wieder auf dem Server veröffentlicht wird. Diese Eigenschaft hat nur dann auswirkungen, wenn der Wert der CausesValidation Eigenschaft auf true. Wenn Sie einen Wert für die ValidationGroup Eigenschaft angeben, werden nur die Überprüfungssteuerelemente überprüft, die Teil der angegebenen Gruppe sind, wenn das ImageButton Steuerelement auf dem Server zurückgibt. Wenn Sie keinen Wert für diese Eigenschaft angeben und die CausesValidation Eigenschaft auf true festgelegt ist, werden alle Überprüfungssteuerelemente auf der Seite überprüft, die keiner Überprüfungsgruppe zugewiesen sind, wenn das Steuerelement wieder auf dem Server veröffentlicht wird.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?