Freigeben über

ValidationSummary-Steuerelement

Zeigt eine Liste aller Validierungsfehler auf der Webseite an.

<asp:ValidationSummary 
id="programmaticID"      DisplayMode="BulletList | List | SingleParagraph"      EnableClientScript="true | false"     ShowSummary="true | false"     ShowMessageBox="true | false"                             HeaderText="TextToDisplayAsSummaryTitle"     runat="server"/>

Hinweise

Mit dem ValidationSummary-Steuerelement werden die Fehlermeldungen aus allen Validierungssteuerelementen an einer Stelle auf der Webseite zusammengefasst. Gemäß dem Wert der DisplayMode-Eigenschaft wird die Zusammenfassung als Liste, Aufzählung oder einzelner Absatz angezeigt. Die Fehlermeldung, die für die einzelnen Validierungssteuerelemente auf der Seite im ValidationSummary-Steuerelement angezeigt wird, wird durch die ErrorMessage-Eigenschaft des jeweiligen Steuerelements angegeben. Wenn die ErrorMessage-Eigenschaft des Validierungssteuerelements nicht gesetzt ist, wird im ValidationSummary-Steuerelement für dieses Validierungssteuerelement keine Fehlermeldung angezeigt. Sie können außerdem im Kopfzeilenabschnitt des ValidationSummary-Steuerelements einen benutzerdefinierten Titel angeben, indem Sie die HeaderText-Eigenschaft festlegen.

Durch Festlegen der ShowSummary-Eigenschaft legen Sie fest, ob das ValidationSummary-Steuerelement angezeigt oder verborgen wird. Außerdem können Sie die Zusammenfassung in einem Meldungsfeld anzeigen, indem Sie die ShowMessageBox-Eigenschaft auf true festlegen.

Weitere Informationen zum ValidationSummary-Steuerelement finden Sie unter ValidationSummary-Klasse.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie mit dem ValidationSummary-Steuerelement eine Zusammenfassung der Eingabesteuerelemente anzeigen, die die Validierung nicht bestanden haben.

<html>
<head>

</head>
<body>

   <h3>ValidationSummary Sample</h3>
   <p>

   <form runat="server">

      <table cellpadding="10">
         <tr>
            <td>
               <table bgcolor="#eeeeee" cellpadding="10">

                  <tr>
                     <td colspan="3">
                        <b>Credit Card Information</b>
                     </td>
                  </tr>
                  <tr>
                     <td align="right">
                        Card Type:
                     </td>
                     <td>
                        <asp:RadioButtonList id="RadioButtonList1" 
                             RepeatLayout="Flow"
                             runat=server>

                           <asp:ListItem>MasterCard</asp:ListItem>
                           <asp:ListItem>Visa</asp:ListItem>

                        </asp:RadioButtonList>
                     </td>
                     <td align="middle" rowspan="1">
                        <asp:RequiredFieldValidator
                             id="RequiredFieldValidator1"
                             ControlToValidate="RadioButtonList1"
                             ErrorMessage="Card Type."
                             Display="Static"
                             InitialValue="" 
                             Width="100%" 
                             Text="*"
                             runat="server"/>
                     </td>
                  </tr>
                  <tr>
                     <td align="right">
                        Card Number:
                     </td>
                     <td>
                        <asp:TextBox id="TextBox1" 
                             runat="server" />
                     </td>
                     <td>
                        <asp:RequiredFieldValidator
                             id="RequiredFieldValidator2"
                             ControlToValidate="TextBox1" 
                             ErrorMessage="Card Number. "
                             Display="Static"
                             Width="100%"
                             Text="*" 
                             runat=server/>
                     </td>
                  </tr>

                  <tr>
                     <td></td>
                     <td>
                        <asp:Button id="Button1" 
                             Text="Validate" 
                             runat=server />
                     </td>
                     <td></td>
                  </tr>
               </table>

            </td>
            <td valign=top>
               <table cellpadding="20">
                  <tr>
                     <td>
                        <asp:ValidationSummary id="valSum" 
                             DisplayMode="BulletList"
                             EnableClientScript="true"
                             HeaderText="You must enter a value in the following fields:"
                             runat="server"/>
                     </td>
                  </tr>
               </table>

            </td>
         </tr>
      </table>

   </form>

</body>
</html>

Siehe auch

ValidationSummary-Klasse | Validierungsserversteuerelemente

  • Last updated on