Kontrolka ASP.NET RangeValidator

Serwerowy kontroler walidacji

Definicja i użycie

Kontrolka RangeValidator służy do sprawdzania, czy wartość wprowadzona przez użytkownika znajduje się między dwoma wartościami. Można porównać różne typy wartości, takie jak liczby, daty oraz znaki.

Komentarz:Jeśli kontrolka wejściowa jest pusta, walidacja nie zakończy się niepowodzeniem. Użyj kontrolki RequiredFieldValidator, aby uczynić pole obowiązkowym.

Komentarz:Jeśli wartość wejściowa nie może być przekształcona na określony typ danych, walidacja nie zakończy się niepowodzeniem. Użyj kontrolki CompareValidator, ustawiając atrybut Operator na ValidationCompareOperator.DataTypeCheck, aby sprawdzić typ danych wartości wejściowej.

Atrybut

Atrybut Opis
BackColor Kolor tła kontrolki RangeValidator
ControlToValidate Id kontrolki do walidacji
Display

Zachowanie wyświetlania kontrolki walidacji.

Dopuszczalne wartości to:

  • Brak - Komunikaty walidacyjne nigdy nie są wyświetlane w trybie wewnętrznym.
  • 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, która określa, czy włączyć walidację klienta.
Enabled Wartość logiczna, która określa, czy włączyć kontrolki walidacji.
ErrorMessage

Tekst wyświetlany w kontrolerze ValidationSummary podczas niepowodzenia walidacji.

Uwaga: Jeśli nie ustawiono atrybutu Text, tekst również zostanie wyświetlony w tym kontrolerze walidacyjnym.
ForeColor Kolor tła kontrolera.
id Unikalny identyfikator kontrolera.
IsValid Wartość logiczna, wskazująca, czy powiązany kontroler wejściowy przeszedł walidację.
MaximumValue Określ maksymalną wartość dla kontrolera wejściowego.
MinimumValue Określ minimalną wartość dla kontrolera wejściowego.
runat Określ, że kontroler jest kontrolerem serwerowym. Musi być ustawiony na "server".
Typ

Określ typ danych do sprawdzenia. Dostępne typy to:

  • Waluta
  • Data
  • Liczba zmiennoprzecinkowa
  • Liczba całkowita
  • Ciąg znaków
Tekst Wiadomość wyświetlana podczas niepowodzenia walidacji.

Przykład

RangeValidator
W tym przykładzie, w pliku .aspx zadeklarowaliśmy kontroler TextBox, przycisk Button oraz kontroler RangeValidator. Jeśli walidacja zakończy się niepowodzeniem, w kontrolerze RangeValidator zostanie wyświetlone tekst "Data musi być między 1/1/2002 a 31/5/2002!".
RangeValidator 2
W tym przykładzie, w pliku .aspx zadeklarowaliśmy kontroler TextBox, przycisk Button, etykietę Label oraz kontroler RangeValidator. Funkcja submit() sprawdza, czy strona jest poprawna. Jeśli jest, w kontrolerze Label zostanie wyświetlone "Strona jest poprawna!". Jeśli nie, w kontrolerze Label zostanie wyświetlone "Strona nie jest poprawna!". Jeśli walidacja zakończy się niepowodzeniem, w kontrolerze RangeValidator zostanie wyświetlone "Wartość musi być z zakresu 1 do 100!".

Serwerowy kontroler walidacji