RegularExpressionAttribute Kelas

Definisi

Ruang nama:

System.ComponentModel.DataAnnotations

Rakitan:

System.ComponentModel.Annotations.dll

Sumber:

RegularExpressionAttribute.cs

Menentukan bahwa nilai bidang data di ASP.NET Data Dinamis harus cocok dengan ekspresi reguler yang ditentukan.

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

Warisan

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut menunjukkan cara menggunakan RegularExpressionAttribute atribut untuk memvalidasi bidang data FirstName dan LastName. Ekspresi reguler memungkinkan hingga 40 karakter huruf besar dan huruf kecil. Contoh melakukan tugas-tugas berikut:

• Menerapkan kelas parsial metadata dan kelas metadata terkait.

• Di kelas metadata terkait, menerapkan RegularExpressionAttribute atribut ke bidang data FirstName dan LastName, menentukan pola dan pesan kesalahan kustom.

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

Keterangan

Anda menerapkan atribut RegularExpressionAttribute ke properti saat Anda perlu memvalidasi nilai untuk properti terhadap ekspresi reguler. Ekspresi reguler memungkinkan Anda menentukan format nilai yang valid dengan sangat tepat. Properti Pola berisi ekspresi reguler. Jika nilai properti null atau string kosong (""), nilai secara otomatis melewati validasi untuk atribut RegularExpressionAttribute. Untuk memvalidasi bahwa nilainya bukan null atau string kosong, gunakan atribut RequiredAttribute .

Ekspresi reguler mencari kecocokan yang tepat, tidak menggunakan ^ sebelum dan $ di akhir pola menghasilkan hasil yang sama seperti menggunakannya. Untuk temuan pencarian, tambahkan dan tambahkan pola dengan .*.

Konstruktor

RegularExpressionAttribute(String)

Menginisialisasi instans baru kelas RegularExpressionAttribute.

Properti

ErrorMessage	Mendapatkan atau mengatur pesan kesalahan untuk dikaitkan dengan kontrol validasi jika validasi gagal. (Diperoleh dari ValidationAttribute)
ErrorMessageResourceName	Mendapatkan atau mengatur nama sumber daya pesan kesalahan yang akan digunakan untuk mencari ErrorMessageResourceType nilai properti jika validasi gagal. (Diperoleh dari ValidationAttribute)
ErrorMessageResourceType	Mendapatkan atau mengatur jenis sumber daya yang akan digunakan untuk pencarian pesan kesalahan jika validasi gagal. (Diperoleh dari ValidationAttribute)
ErrorMessageString	Mendapatkan pesan kesalahan validasi yang dilokalkan. (Diperoleh dari ValidationAttribute)
MatchTimeout	Mendapatkan batas waktu untuk digunakan saat mencocokkan pola ekspresi reguler
MatchTimeoutInMilliseconds	Mendapatkan atau mengatur jumlah waktu dalam milidetik untuk menjalankan satu operasi pencocokan sebelum operasi habis.
Pattern	Mendapatkan pola ekspresi reguler.
RequiresValidationContext	Mendapatkan nilai yang menunjukkan apakah atribut memerlukan konteks validasi. (Diperoleh dari ValidationAttribute)
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
FormatErrorMessage(String)	Memformat pesan kesalahan untuk ditampilkan jika validasi ekspresi reguler gagal.
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetValidationResult(Object, ValidationContext)	Memeriksa apakah nilai yang ditentukan valid sehubungan dengan atribut validasi saat ini. (Diperoleh dari ValidationAttribute)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
IsValid(Object)	Memeriksa apakah nilai yang dimasukkan oleh pengguna cocok dengan pola ekspresi reguler.
IsValid(Object, ValidationContext)	Memvalidasi nilai yang ditentukan sehubungan dengan atribut validasi saat ini. (Diperoleh dari ValidationAttribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Validate(Object, String)	Memvalidasi objek yang ditentukan. (Diperoleh dari ValidationAttribute)
Validate(Object, ValidationContext)	Memvalidasi objek yang ditentukan. (Diperoleh dari ValidationAttribute)