RegularExpressionAttribute 클래스

정의

네임스페이스:

System.ComponentModel.DataAnnotations

어셈블리:

System.ComponentModel.Annotations.dll

Source:

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개의 대문자 및 소문자를 허용합니다. 이 예제에서는 다음 작업을 수행합니다.

• 메타데이터 partial 클래스 및 연결된 메타데이터 클래스를 구현합니다.

• 연결된 메타데이터 클래스에서 는 FirstName 및 LastName 데이터 필드에 특성을 적용 RegularExpressionAttribute 하여 패턴 및 사용자 지정 오류 메시지를 지정합니다.

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	작업의 제한 시간이 초과되기 전에 단일 일치 작업을 실행하는 총 시간(밀리초)을 가져오거나 설정합니다.
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)