BaseValidator.ErrorMessage Property (System.Web.UI.WebControls)

ErrorMessage Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

.NET Framework Class Library

BaseValidator.ErrorMessage Property

Gets or sets the text for the error message displayed in a ValidationSummary control when validation fails.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

Visual Basic (Declaration)

<LocalizableAttribute(True)> _
Public Property ErrorMessage As String

Visual Basic (Usage)

Dim instance As BaseValidator
Dim value As String

value = instance.ErrorMessage

instance.ErrorMessage = value

[LocalizableAttribute(true)] 
public string ErrorMessage { get; set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property String^ ErrorMessage {
    String^ get () sealed;
    void set (String^ value) sealed;
}

/** @property */
public final String get_ErrorMessage ()

/** @property */
public final void set_ErrorMessage (String value)

JScript

public final function get ErrorMessage () : String

public final function set ErrorMessage (value : String)

Property Value

The error message displayed in a ValidationSummary control when validation fails. The default value is an empty string (""), which indicates that this property is not set.

Remarks

When using a ValidationSummary control, use the ErrorMessage property to specify the text to display in the ValidationSummary control when validation fails for the current validation control. To specify the text to display in the validation control itself, use the Text property.

Note
If you set the ErrorMessage property without setting the Text property, the value of the ErrorMessage property is also displayed in the validation control.

The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

Topic	Location
How to: Disable Validation for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Disable Validation for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Disable Validation for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Display Server Side Custom Validation Messages for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Display Server Side Custom Validation Messages for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Display Server Side Custom Validation Messages for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Format Validation Error Messages for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Format Validation Error Messages for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Format Validation Error Messages for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Specify Layout for In-Place Messages On ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Specify Layout for In-Place Messages On ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Specify Layout for In-Place Messages On ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Test Validity Programmatically for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Test Validity Programmatically for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Test Validity Programmatically for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate Against a Data Type for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against a Data Type for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against a Data Type for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate Against a Range of Values for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against a Range of Values for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against a Range of Values for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate Against a Specific Value for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against a Specific Value for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against a Specific Value for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate Against Patterns for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against Patterns for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against Patterns for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate Against Values in a Database for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against Values in a Database for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Against Values in a Database for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate Programmatically for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Programmatically for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Programmatically for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate Required Entries for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Required Entries for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate Required Entries for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
How to: Validate with a Custom Function for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate with a Custom Function for ASP.NET Server Controls	Building ASP .NET Web Applications
How to: Validate with a Custom Function for ASP.NET Server Controls	Building ASP .NET Web Applications in Visual Studio
Walkthrough: Validating User Input in a Web Forms Page	Building ASP .NET Web Applications in Visual Studio
Walkthrough: Validating User Input in a Web Forms Page	Building Applications with Visual Web Developer

Example

The following code example demonstrates how to use the ErrorMessage property to specify different messages for the ValidationSummary control and the RequiredFieldValidator and CompareValidator controls.

Visual Basic

<%@ Page Language="VB" AutoEventWireup="False" %>

<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</script>

<html>
  <body>
    <form runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br><br>

      <asp:button id="SubmitButton"
        text="Submit"
        runat="server"/>
 
      <br><br>
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br><br>

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html>
  <body>
    <form runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br><br>

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br><br>
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br><br>

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

JScript

<%@ Page Language="JScript" %>

<script runat="server">
 
  function Button_Click(sender, e : EventArgs) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html>
  <body>
    <form runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br><br>

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br><br>
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br><br>

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

Platforms

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

Reference

BaseValidator Class
BaseValidator Members
System.Web.UI.WebControls Namespace
ValidationSummary
Text

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Property Value

.NET Framework

Reference