Skip to content

<Validate Type="Email">

The Email validator prevents the form from being submitted unless the target control's value looks like a valid email address. It uses a built-in regex that handles most well-formed email addresses — a convenient shortcut so you don't have to write your own pattern.

Format only — not deliverability

This validator only checks the shape of the address, not whether the inbox actually exists or accepts mail. To verify deliverability you need a separate confirmation step (e.g. send a "click here to confirm" email).

If the built-in pattern doesn't fit your needs, use <Validate Type="RegEx"> with your own ValidationExpression.

Example

html
<AddForm>
  ...
  <table>
    <tr>
      <td>
        <Label For="txtEmail" Text="Email" />
        <TextBox Id="txtEmail" DataField="Email" DataType="string" />
        <Validate Type="Email" Target="txtEmail" Message="Please enter a valid email address" />
      </td>
    </tr>
    <tr>
      <td colspan="2">
        <AddButton Text="Add" />&nbsp;<CancelButton Text="Cancel" />
        <ValidationSummary />
      </td>
    </tr>
  </table>
</AddForm>

Properties

PropertyValuesDefaultDescription
Type *EmailIdentifies this as an Email validator
Target *control IDID of the control to validate
CssClassstringCSS class name(s) for styling the validator's error display
DisplayStatic DynamicDynamicWhether the validator reserves layout space when no error is shown
EnableClientScriptTrue FalseTrueWhen True, validation runs in the browser as well as on the server
HeightsizeHeight of the validator's error display
MessagestringText shown in the <ValidationSummary> when validation fails
TextstringText shown inline at the validator's location when validation fails
WidthsizeWidth of the validator's error display

* Required property

Deprecated Properties

These properties use ASP.NET inline styling and are no longer recommended for modern web development. Use the CssClass property to apply CSS classes or the Style property for inline CSS instead.

PropertyValuesDescription
BackColorcolor name | #ddddddBackground color of the validator's error display
BorderColorcolor name | #ddddddBorder color
BorderStyleNotSet None Dotted Dashed Solid Double Groove Ridge Inset OutsetBorder style
BorderWidthsizeBorder width
Font-BoldTrue FalseBold text
Font-ItalicTrue FalseItalic text
Font-NamesstringFont family name
Font-OverlineTrue FalseOverline text decoration
Font-SizeXX-Small X-Small Small Medium Large X-Large XX-Large or sizeFont size
Font-StrikeoutTrue FalseStrikethrough text decoration
Font-UnderlineTrue FalseUnderline text decoration
ForeColorcolor name | #ddddddText color. Note: the validator hard-codes red, bold text by default. If you set CssClass, XMP automatically clears ForeColor so your stylesheet's color rules take effect

Property Details

  • Type: Set to Email to identify this as an Email validator.

  • Target: The ID of the form control whose value should be checked.

  • Message: The error text shown in the <ValidationSummary> (if you have one) when validation fails. If no <ValidationSummary> is present, this text appears at the validator's location instead.

  • Text: The text shown inline at the validator's location when validation fails. Used together with Message and <ValidationSummary>: a short inline marker (*, **, or an icon) at the validator + the full sentence in the summary block.

  • Display: Whether the validator reserves layout space even when no error is shown. Dynamic (the default) collapses to no space until validation fails. Static always reserves space.

  • EnableClientScript: When True (the default), the validator runs in the browser before the form is submitted, giving the user immediate feedback. Set to False to force server-side-only validation.