Kontrolka CustomValidator ASP.NET

Definicja i użycie

Kontrolka CustomValidator może wykonywać użytkownicze zdefiniowane walidacje na kontrolkach wejściowych.

Atrybut

Atrybut Opis
BackColor Kolor tła kontrolki CustomValidator.
ClientValidationFunction

Określa nazwę niestandardowej funkcji klienta używanej do walidacji.

Komentarz: Skrypty muszą być napisane w języku obsługiwanym przez przeglądarkę, np. VBScript lub JScript

Jeśli używasz VBScript, funkcje muszą znajdować się w formularzu:

Sub FunctionName (source, arguments)

Jeśli używasz JScript, funkcje muszą znajdować się w formularzu:

Funkcja FunctionName (source, arguments)

ControlToValidate Identyfikator kontrolera wejściowego do walidacji.
Display

Zachowanie wyświetlania błędów w kontrolerze walidacyjnym.

Dopuszczalne wartości to:

  • Brak - Komunikaty walidacyjne nigdy nie są wyświetlane wtrybie wklejenia.
  • Statyczny - Przestrzeń do wyświetlania komunikatów walidacyjnych jest przydzielona w układzie strony.
  • Dynamiczny - Jeśli walidacja zakończy się niepowodzeniem, przestrzeń do wyświetlania komunikatów walidacyjnych zostanie dynamicznie dodana do strony.
EnableClientScript Wartość logiczna, wskazująca, czy walidacja klienta jest włączona.
Enabled Wartość logiczna, wskazująca, czy kontroler walidacji jest włączony.
ErrorMessage

Tekst błędu wyświetlany w kontrolerze ValidationSummary przy niepowodzeniu walidacji.

Uwaga: Jeśli ustawiono atrybut ErrorMessage, ale nie ustawiono atrybutu Text, wartość atrybutu ErrorMessage również zostanie wyświetlona w kontrolerze walidacji.

ForeColor Przód kontrolera.
id Unikalny identyfikator kontrolera.
IsValid Wartość logiczna, wskazująca, czy powiązany kontroler wejściowy przejdzie walidację.
OnServerValidate Określa nazwę funkcji skryptu walidacji serwerowej do wykonania.
runat Określa, że kontroler jest kontrolerem serwerowym. Musi być ustawiony na "server".
Tekst Tekst wyświetlany przy niepowodzeniu walidacji.

Przykład

CustomValidator
W tym przykładzie, deklarujemy dwa kontrolery Label, jeden kontroler TextBox, jeden przycisk oraz kontroler CustomValidator w pliku .aspx. Funkcja user() może wykryć długość wprowadzonej wartości. Jeśli długość jest mniejsza niż 8 lub większa niż 16, tekst "Nazwa użytkownika musi zawierać od 8 do 16 znaków!" zostanie wyświetlony w kontrolerze CustomValidator.