Ελεγκτής CustomValidator του ASP.NET

Ορισμός και χρήση

Ο έλεγχος CustomValidator μπορεί να εκτελεί χρήσιμες επαλήθευσεις για τα κουτιά εισαγωγής.

Πρότυπο

Πρότυπο Περιγραφή
BackColor Ο χρωματισμός του παρασκηνίου του ελέγχου CustomValidator
ClientValidationFunction

Ονομασία της προσαρμοσμένης συνάρτησης κειμένου για την επαλήθευση.

Σημείωση: Ο κώδικας των σクリπτ πρέπει να γραφτεί σε γλώσσα που υποστηρίζεται από τον περιηγητή, όπως VBScript ή JScript

Για να χρησιμοποιήσετε το VBScript, η συνάρτηση πρέπει να βρίσκεται μέσα στην φόρμα:

Sub FunctionName (source, arguments)

Για να χρησιμοποιήσετε το JScript, η συνάρτηση πρέπει να βρίσκεται μέσα στην φόρμα:

Function FunctionName (source, arguments)

ControlToValidate Το id του ελέγχου εισόδου που πρέπει να επαληθευτεί.
Display

Το μοτίβο εμφάνισης των σφαλμάτων στο ελέγχου επαλήθευσης.

Λοιπές νόμιμες τιμές:

  • Απενεργοποιημένο - Το μήνυμα επαλήθευσης δεν θα εμφανίζεται ενσωματωμένα.
  • Στατικό - Ο χώρος που θα χρησιμοποιηθεί για την εμφάνιση του μηνύματος επαλήθευσης θα παραχωρηθεί στη διάταξη της σελίδας.
  • Δυναμικό - Αν αποτύχει η επαλήθευση, ο χώρος που θα χρησιμοποιηθεί για την εμφάνιση του μηνύματος επαλήθευσης θα προστεθεί δυναμικά στη σελίδα.
EnableClientScript Βολική τιμή, υποδεικνύει αν είναι ενεργοποιημένη η επαλήθευση πελάτη.
Enabled Βολική τιμή, υποδεικνύει αν ο ελέγχος επαλήθευσης είναι ενεργοποιημένος.
ErrorMessage

Το κείμενο των σφαλμάτων που εμφανίζεται στο ελέγχου ValidationSummary όταν αποτύχει η επαλήθευση.

Σημείωση: Αν έχει οριστεί η ιδιότητα ErrorMessage αλλά δεν έχει οριστεί η ιδιότητα Text, τότε θα εμφανιστεί και η τιμή της ιδιότητας ErrorMessage στο ελέγχου επαλήθευσης.

ForeColor Ο προεπιλεγμένος χρωματισμός του ελέγχου.
id Ο μοναδικός id του ελέγχου.
IsValid Βολική τιμή, υποδεικνύει αν ο σχετικός ελέγχος εισόδου έχει περάσει την επαλήθευση.
OnServerValidate Ορίζει το όνομα της συνάρτησης επαλήθευσης του διακομιστή που θα εκτελεστεί.
runat Ορίζει ότι ο ελέγχος είναι ελεγκτικό σύστημα υπηρεσίας. Πρέπει να ρυθμιστεί σε "server".
Κείμενο Το κείμενο που εμφανίζεται όταν η επαλήθευση αποτύχει.

Παράδειγμα

CustomValidator
Σε αυτό το παράδειγμα, ανακήρυξα δύο ελέγχους Label, έναν ελέγχου TextBox, έναν ελέγχου Button και έναν ελέγχου CustomValidator στο αρχείο .aspx. Η συνάρτηση user() μπορεί να ελέγξει τη διάρκεια της εισόδου. Αν η διάρκεια είναι μικρότερη από 8 ή μεγαλύτερη από 16, θα εμφανιστεί το κείμενο "Το όνομα χρήστη πρέπει να βρίσκεται μεταξύ 8 και 16 χαρακτήρων!" στο ελέγχου CustomValidator.