RegularExpressionAttribute 類別

定義

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

繼承

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 屬性包含正則表達式。 若屬性值為空或為空字串（“”），該值會自動通過 RegularExpressionAttribute 屬性的驗證。 要驗證該值是否為 null 空字串，請使用 RequiredAttribute 屬性。

正則表達式搜尋完全匹配的，不使用 ^ 模式的前後 $ 與結束時，結果與使用它相同的結果。 搜尋結果時，在前 .*加並加上 。

另請參閱

• .NET 規則運算式