RegularExpressionAttribute クラス

定義

動的データのデータ フィールド値 ASP.NET 指定した正規表現と一致する必要があることを指定します。

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.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
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute
Public Class RegularExpressionAttribute
Inherits ValidationAttribute
継承
RegularExpressionAttribute
属性

次の例は、 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)
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, ValidationContext)

現在の検証属性に関して、指定した値を検証します。

(継承元 ValidationAttribute)
IsValid(Object)

ユーザーが入力した値が正規表現パターンと一致するかどうかを確認します。

Match(Object)

派生クラスでオーバーライドされた場合、このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。

(継承元 Attribute)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
Validate(Object, String)

指定したオブジェクトを検証します。

(継承元 ValidationAttribute)
Validate(Object, ValidationContext)

指定したオブジェクトを検証します。

(継承元 ValidationAttribute)

明示的なインターフェイスの実装

名前 説明
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。

(継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

インターフェイスの型情報を取得するために使用できるオブジェクトの型情報を取得します。

(継承元 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。

(継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されるプロパティとメソッドへのアクセスを提供します。

(継承元 Attribute)

適用対象

こちらもご覧ください