ASP.NET CustomValidator Kontrolü

Tanım ve Kullanım

CustomValidator kontrolü, kullanıcı tanımlı doğrulamaları girebilen girdi kontrollerini çalıştırabilir.

Özellik

Özellik Açıklama
BackColor CustomValidator kontrolünün arka plan rengi.
ClientValidationFunction

Doğrulama için kullanılan özelleştirilmiş istemci betik fonksiyonunun adını belirler.

Açıklama: Betikler, tarayıcı tarafından desteklenen bir dilde yazılmalıdır, örneğin VBScript veya JScript

VBScript kullanılıyorsa, fonksiyonlar form içinde olmalıdır:

Sub FunctionName (source, arguments)

JScript kullanılıyorsa, fonksiyonlar form içinde olmalıdır:

Function FunctionName (source, arguments)

ControlToValidate Doğrulanacak giriş denetleyicisinin id'si.
Display

Doğrulama denetleyicisinde hata mesajının görüntüleme davranışı.

Geçerli değerler:

  • None - Doğrulama mesajı asla içe aktif olarak görüntülenmez.
  • Static - Sayfa düzeninde doğrulama mesajını görüntülemek için ayrılan alan.
  • Dynamic - Doğrulama başarısız olduğunda, doğrulama mesajını görüntülemek için sayfaya dinamik olarak eklenen alan.
EnableClientScript Boolean değer, bu değerin, istemci doğrulamasını etkinleştirip etkinleştirmediğini belirtir.
Enabled Boolean değer, bu değerin, doğrulama denetleyicisinin etkin olup olmadığını belirtir.
ErrorMessage

Doğrulama başarısız olduğunda ValidationSummary denetleyicisinde görüntülenen hata mesajı metni.

Açıklama: ErrorMessage özelliği ayarlandıysa ve Text özelliği ayarlanmadıysa, doğrulama denetleyicisinde ErrorMessage özelliğinin değeri de görüntülenir.

ForeColor Denetleyicinin ön plan rengi.
id Denetleyicinin benzersiz id'si.
IsValid Boolean değer, bu değerin, ilgili giriş denetleyicisinin doğrulama geçirip geçirmediğini belirtir.
OnServerValidate Çalıştırılacak sunucu tarafı doğrulama betik fonksiyonunun adını belirtir.
runat Bu denetleyicinin sunucu denetleyicisi olduğunu belirtir. "server" olarak ayarlanmalıdır.
Metin Doğrulama başarısız olduğunda görüntülenen metin.

Örnek

CustomValidator
Bu örnekte, .aspx dosyasında iki Label denetleyicisi, bir TextBox denetleyicisi, bir Button denetleyicisi ve bir CustomValidator denetleyicisi tanımladık. user() fonksiyonu, girilen değerin uzunluğunu saptar. Uzunluk 8'den küçük veya 16'dan büyükse, CustomValidator denetleyicisinde "Kullanıcı adı 8 ila 16 karakter arasında olmalıdır!" metni görüntülenir.