RegularExpressionAttribute 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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.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 FirstName 및 LastName 데이터 필드의 유효성을 검사하는 방법을 보여줍니다. 정규식은 최대 40개의 대문자와 소문자를 허용합니다. 이 예제에서는 다음 작업을 수행합니다.
- 메타데이터 부분 클래스 및 연결된 메타데이터 클래스를 구현합니다.
- 연결된 메타데이터 클래스에서 패턴 및 사용자 지정 오류 메시지를 지정하여 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 특성을 사용합니다.
정규식은 패턴의 앞과 $ 끝에서 사용하지 ^ 않고 정확한 일치 항목을 검색하여 이를 사용하는 것과 동일한 결과를 생성합니다. 검색 적중의 경우 패턴을 앞에 추가하고 .와 함께 .*추가합니다.
생성자
| Name | Description |
|---|---|
| RegularExpressionAttribute(String) |
RegularExpressionAttribute 클래스의 새 인스턴스를 초기화합니다. |
속성
| Name | Description |
|---|---|
| ErrorMessage |
유효성 검사에 실패할 경우 유효성 검사 컨트롤과 연결할 오류 메시지를 가져오거나 설정합니다. (다음에서 상속됨 ValidationAttribute) |
| ErrorMessageResourceName |
유효성 검사에 실패할 경우 속성 값을 조회 ErrorMessageResourceType 하기 위해 사용할 오류 메시지 리소스 이름을 가져오거나 설정합니다. (다음에서 상속됨 ValidationAttribute) |
| ErrorMessageResourceType |
유효성 검사에 실패할 경우 오류 메시지 조회에 사용할 리소스 유형을 가져오거나 설정합니다. (다음에서 상속됨 ValidationAttribute) |
| ErrorMessageString |
지역화된 유효성 검사 오류 메시지를 가져옵니다. (다음에서 상속됨 ValidationAttribute) |
| MatchTimeoutInMilliseconds |
작업 시간이 초과되기 전에 단일 일치 작업을 실행하는 데 걸리는 시간(밀리초)을 가져오거나 설정합니다. |
| Pattern |
정규식 패턴을 가져옵니다. |
| RequiresValidationContext |
특성에 유효성 검사 컨텍스트가 필요한지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ValidationAttribute) |
| TypeId |
파생 클래스에서 구현되는 경우 이 Attribute대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute) |
메서드
| Name | Description |
|---|---|
| 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) |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| _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) |