共用方式為

ValidationSummary 控制項

在 Web 網頁上顯示驗證錯誤清單。

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

備註

ValidationSummary 可以讓您在 Web 網頁上的單一位置摘要來自所有驗證控制項的錯誤訊息。根據 DisplayMode 屬性的值，摘要可以顯示為清單、項目符號清單或單一段落。為網頁上每一個驗證控制項顯示在 ValidationSummary 控制項中的錯誤訊息，這是由每一個驗證控制項的 ErrorMessage 屬性所指定的。如果沒有設定驗證控制項的 ErrorMessage 屬性，在該驗證控制項的 ValidationSummary 控制項中不會顯示任何錯誤訊息。您也可以設定 HeaderText 屬性來指定 ValidationSummary 控制項的標題區段的自訂標題。

您可以設定 ShowSummary 屬性來控制顯示或隱藏 ValidationSummary 控制項。而將 ShowMessageBox 屬性設為 true，也可以在訊息方塊中顯示摘要。

如需 ValidationSummay 控制項的詳細資訊，請參閱 ValidationSummary 類別。

範例

下列範例示範如何使用 ValidationSummary 控制項來摘要在網頁上驗證失敗的輸入控制項。

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

請參閱

ValidationSummary 類別 | 驗證伺服器控制項

  • Last updated on