Classe ValidationSummary

Consente di visualizzare un riepilogo di tutti gli errori di convalida che si sono verificati in un form.

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

Osservazioni

La classe ValidationSummary consente di creare un riepilogo di tutti gli errori di convalida visualizzandoli inline o in un form separato. Per gli errori visualizzati mediante una delle due modalità, nel controllo ValidationSummary viene utilizzato il testo della proprietà ErrorMessage.

Sebbene nella maggior parte dei casi il comportamento della classe ValidationSummary nei controlli mobili ASP .NET sia analogo a quello della classe ValidationSummary in Web Forms, la versione della classe relativa ai controlli mobili non eredita direttamente dalla versione Web Forms della classe. Pertanto le proprietà che consentono di modificare l'output del riepilogo degli errori di convalida, ad esempio la proprietà DisplayMode, non sono disponibili nei controlli mobili. La versione del riepilogo per i controlli mobili deriva direttamente dalla classe MobileControl.

Esempio

Nel codice di esempio riportato di seguito viene illustrato come creare un'istanza della classe ValidationSummary e aggiungerla a un form in un'applicazione Web mobile ASP. NET durante il caricamento di una pagina. La funzione Page_Load definita dall'utente rileva se si è verificato un errore e quindi avvia il form che contiene il controllo ValidationSummary o il form di ringraziamento.

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

Requisiti

Spazio dei nomi: System.Web.UI.MobileControls

Assembly: System.Web.Mobile

Vedere anche

Controllo ValidationSummary