ValidationSummary 類別

顯示所有發生在表單上之驗證錯誤的摘要。

public class System.Web.UI.MobileControls.ValidationSummary : 
   System.Web.UI.MobileControls.MobileControl

備註

ValidationSummary 類別會建立所有驗證錯誤的摘要，並且將它們內嵌 (Inline) 在表單中或展示在單獨的表單上。ValidationSummary 控制項使用 ErrorMessage 屬性中的文字作為錯誤訊息，該訊息會內嵌 (Inline) 顯示在表單中或顯示在摘要表單上。

雖然在許多方面，ASP.NET Mobile 控制項的 ValidationSummary 類別模仿 Web Form ValidationSummary 類別的行為，但是行動控制項版本的類別沒有直接繼承 Web Form 版本的類別。所以，修改驗證摘要輸出的屬性 (例如 DisplayMode 屬性) 在行動控制項中不可使用。行動控制項版本的摘要是直接衍生自 MobileControl 類別。

範例

下列程式碼範例示範如何建立 ValidationSummary 類別的執行個體，並且在頁面載入期間將它加入 ASP.NET Mobile Web 應用程式的表單中。使用者定義的 Page_Load 函式會判斷是否有錯誤，然後決定啟動包含 ValidationSummary 控制項的表單，或啟動祝賀的感謝表單。

<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage" 
   Language="VB" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script runat="server" language="vb">

Sub Page_Load(sender As Object, e As EventArgs)
   ' Define validation expressions.
   revUserName.ValidationExpression = "^[a-zA-Z](.{1,9})$"
   revPhone.ValidationExpression = _
      "((\\(\\d{3}\\) ?)|(\\d{3}-))?\\d{3}-\\d{4}"

   rfvUserName.Text = "User name is required"
   revUserName.Text = "Must be between 2 to 10 characters long"
   revPhone.Text = "Please provide a valid number: (425) 555-0187"

   ' ErrorMessages appear in ValidationSummary.
   revUserName.ErrorMessage = "Incorrect UserName format. Name" + _ 
                              " can be 2 to 10 characters long"
   rfvUserName.ErrorMessage = "User name required"
   revPhone.ErrorMessage = "Please provide a valid number: " + _
                           "(425) 555-0187"
End Sub

Sub OnCmdClick1(sender As Object, e As EventArgs)
   If Page.IsValid Then
      ActiveForm = Form2
   End If
End Sub
</script>

<mobile:Form runat="server" id="Form1" >
   <mobile:Label runat="server" id="lblHeading" 
      Text="Provide your name and number" StyleReference="title" />   
   <mobile:Label runat="server" id="lblUserName" 
      Text="User Name (req'd)" />
   <mobile:Textbox  runat="server" id="txtUserName"/>
   <mobile:RequiredFieldValidator runat="server" id="rfvUserName" 
      ControlToValidate="txtUserName" />
   <mobile:RegularExpressionValidator runat="server" id="revUserName" 
      ControlToValidate="txtUserName" />
   <mobile:Label runat="server" id="lblPhone" Text="Phone" />
   <mobile:Textbox  runat="server" id="txtPhone"/>
   <mobile:RegularExpressionValidator runat="server" id="revPhone" 
      ControlToValidate="txtPhone" />
   <mobile:ValidationSummary FormToValidate="Form1"
      HeaderText="Error Summary:"
      runat="server" />
   <mobile:Command runat="server" id="Command1" text="Submit" 
      OnClick="OnCmdClick1"/>
</mobile:Form>

<mobile:Form runat="server" id="Form2" >
   <mobile:Label runat="server" Text="Thank You." />
</mobile:Form>
[C#]
<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage" 
   Language="c#" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script runat="server" language="c#">

void Page_Load(Object sender, EventArgs e)
{
   // Define validation expressions.
   revUserName.ValidationExpression = "^[a-zA-Z](.{1,9})$";
   revPhone.ValidationExpression = 
      "((\\(\\d{3}\\) ?)|(\\d{3}-))?\\d{3}-\\d{4}";

   rfvUserName.Text = "User name is required";
   revUserName.Text = "Must be between 2 to 10 characters long";
   revPhone.Text = "Please provide a valid number: (425) 555-0187";

   // ErrorMessages appear in ValidationSummary.
   revUserName.ErrorMessage = "Incorrect UserName format. Name" + 
                              " can be 2 to 10 characters long";
   rfvUserName.ErrorMessage = "User name required";
   revPhone.ErrorMessage = "Please provide a valid number: " +
                           "(425) 555-0187";
}

void OnCmdClick1(Object sender, EventArgs e)
{
   if (Page.IsValid)
   {
      ActiveForm = Form2;
   }
}
</script>

<mobile:Form runat="server" id="Form1" >
   <mobile:Label runat="server" id="lblHeading" 
      Text="Provide your name and number" StyleReference="title" />   
   <mobile:Label runat="server" id="lblUserName" 
      Text="User Name (req'd)" />
   <mobile:Textbox  runat="server" id="txtUserName"/>
   <mobile:RequiredFieldValidator runat="server" id="rfvUserName" 
      ControlToValidate="txtUserName" />
   <mobile:RegularExpressionValidator runat="server" id="revUserName" 
      ControlToValidate="txtUserName" />
   <mobile:Label runat="server" id="lblPhone" Text="Phone" />
   <mobile:Textbox  runat="server" id="txtPhone"/>
   <mobile:RegularExpressionValidator runat="server" id="revPhone" 
      ControlToValidate="txtPhone" />
   <mobile:ValidationSummary FormToValidate="Form1"
      HeaderText="Error Summary:"
      runat="server" />
   <mobile:Command runat="server" id="Command1" text="Submit" 
      OnClick="OnCmdClick1"/>
</mobile:Form>

<mobile:Form runat="server" id="Form2" >
   <mobile:Label runat="server" Text="Thank You." />
</mobile:Form>

需求

命名空間：System.Web.UI.MobileControls

**組件：**System.Web.Mobile

請參閱

ValidationSummary 控制項