RegularExpressionAttribute クラス

定義

名前空間:

System.ComponentModel.DataAnnotations

アセンブリ:

System.ComponentModel.Annotations.dll

ソース:

RegularExpressionAttribute.cs

ASP.NET Dynamic Data のデータ フィールド値が指定した正規表現に一致しなければならないことを指定します。

public ref class RegularExpressionAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class RegularExpressionAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute

Public Class RegularExpressionAttribute
Inherits ValidationAttribute

継承

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

属性

AttributeUsageAttribute

例

次の例は、 RegularExpressionAttribute 属性を使用して FirstName および LastName データ フィールドを検証する方法を示しています。 正規表現では、最大 40 文字の大文字と小文字を使用できます。 この例では、次のタスクを実行します。

• メタデータ部分クラスと、関連付けられているメタデータ クラスを実装します。

• 関連付けられたメタデータ クラスで、 属性を RegularExpressionAttribute FirstName データ フィールドと LastName データ フィールドに適用し、パターンとカスタム エラー メッセージを指定します。

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;

[MetadataType(typeof(CustomerMetaData))]
public partial class Customer
{
}

public class CustomerMetaData
{
   
    // Allow up to 40 uppercase and lowercase 
    // characters. Use custom error.
    [RegularExpression(@"^[a-zA-Z''-'\s]{1,40}$", 
         ErrorMessage = "Characters are not allowed.")]
    public object FirstName;

    // Allow up to 40 uppercase and lowercase 
    // characters. Use standard error.
    [RegularExpression(@"^[a-zA-Z''-'\s]{1,40}$")]
    public object LastName;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations


<MetadataType(GetType(CustomerMetaData))> _
Partial Public Class Customer

    
End Class

Public Class CustomerMetaData
    
    ' Allow up to 40 uppercase and lowercase 
    ' characters. Use custom error.
    <RegularExpression("^[a-zA-Z''-'\s]{1,40}$", _
                       ErrorMessage:="Characters are not allowed.")> _
    Public FirstName As Object

    ' Allow up to 40 uppercase and lowercase 
    ' characters. Use standard error.
    <RegularExpression("^[a-zA-Z''-'\s]{1,40}$")> _
    Public LastName As Object
End Class

注釈

正規表現に対してプロパティの値を検証する必要がある場合は、RegularExpressionAttribute 属性をプロパティに適用します。 正規表現を使用すると、有効な値の形式を非常に正確に指定できます。 Pattern プロパティには正規表現が含まれています。 プロパティの値が null または空の文字列 ("") の場合、値は RegularExpressionAttribute 属性の検証に自動的に合格します。 値がまたは空の文字列ではないこと null を検証するには、 RequiredAttribute 属性を使用します。

正規表現は、パターンの前後で を使用 ^ せず、完全一致を検索し、それを使用した場合と $ 同じ結果を生成します。 検索ヒットの場合は、 の前に パターン .*を追加します。

コンストラクター

RegularExpressionAttribute(String)

RegularExpressionAttribute クラスの新しいインスタンスを初期化します。

プロパティ

ErrorMessage	検証が失敗した場合に検証コントロールに関連付けるエラー メッセージを取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageResourceName	検証が失敗した場合に ErrorMessageResourceType プロパティ値の検索に使用するエラー メッセージ リソース名を取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageResourceType	検証が失敗した場合にエラー メッセージの検索に使用するリソースの種類を取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageString	ローカライズされた検証エラー メッセージを取得します。 (継承元 ValidationAttribute)
MatchTimeout	正規表現パターンを照合するときに使用するタイムアウトを取得します
MatchTimeoutInMilliseconds	操作がタイムアウトする前に 1 つの一致操作を実行するミリ秒単位の時間を取得または設定します。
Pattern	正規表現パターンを取得します。
RequiresValidationContext	属性で検証コンテキストが必要かどうかを示す値を取得します。 (継承元 ValidationAttribute)
TypeId	派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute)

メソッド

Equals(Object)	このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。 (継承元 Attribute)
FormatErrorMessage(String)	正規表現検証が失敗した場合に表示するエラー メッセージを書式設定します。
GetHashCode()	このインスタンスのハッシュ コードを返します。 (継承元 Attribute)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValidationResult(Object, ValidationContext)	現在の検証属性に対して、指定した値が有効かどうかを確認します。 (継承元 ValidationAttribute)
IsDefaultAttribute()	派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute)
IsValid(Object)	ユーザーが入力した値が正規表現パターンと一致するかどうかをチェックします。
IsValid(Object, ValidationContext)	現在の検証属性に対して、指定した値を検証します。 (継承元 ValidationAttribute)
Match(Object)	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Validate(Object, String)	指定されたオブジェクトを検証します。 (継承元 ValidationAttribute)
Validate(Object, ValidationContext)	指定されたオブジェクトを検証します。 (継承元 ValidationAttribute)