RegularExpressionValidator クラス
RegularExpressionValidatorは、ASP.NETのユーザー入力を指定の正規表現と合致するか検証するバリデーションコントロールです。
RegularExpressionValidator コントロールを使用する手順は次のとおりです。
- ASP.NETページでは、RegularExpressionValidatorコントロールを追加します。コントロールをページにドラッグアンドドロップで追加するか、コントロールのコードを手動で追加します。
- 検証するコントロールのIDをControlToValidateプロパティに設定する。たとえば、TextBoxコントロールの入力を検証する場合は、ControlToValidateプロパティをTextBoxコントロールのIDに設定する。
- ValidationExpressionプロパティを、検証を行う正規表現に設定します。例えば、メールアドレスの入力を検証したい場合は、ValidationExpressionプロパティに、正当なメールアドレスの正規表現を設定します。
- オプションで、ErrorMessageプロパティを設定して、検証に失敗した場合に表示するエラーメッセージを定義できます。
- 表示に失敗した場合のエラーメッセージを表示する方法は、Displayプロパティで定義可能(省略時はStatic)。一般的な値は、Static(ページに表示)、Dynamic(JavaScriptで表示)。
RegularExpressionValidator コントロールを使用した電子メールアドレスの検証の実装サンプルコードを以下に示します。
<asp:TextBox ID="txtEmail" runat="server" />
<asp:RegularExpressionValidator ID="regexEmail" runat="server" ControlToValidate="txtEmail"
ValidationExpression="\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*"
ErrorMessage="请输入合法的邮箱地址"
Display="Static" />
上のコードでは、txtEmail が検証したい TextBox コントロールの ID であり、regexEmail が RegularExpressionValidator コントロールの ID です。 ValidationExpression プロパティはメールアドレスを検証する正規表現を設定し、ErrorMessage プロパティは検証が失敗したときのエラーメッセージを設定し、Display プロパティはエラーメッセージの表示方法を Static(つまりページに表示される)に設定します。
指定された正規表現規則に一致しないメールアドレスが入力されると、RegularExpressionValidator コントロールは、ErrorMessage で定義されたエラー メッセージを表示します。