Table of Contents

FormValidators 提供多種預設驗證器,涵蓋常見的資料驗證需求。

基本驗證

RequiredValidator

驗證 Value 是否為必填。如果值為 null、空字串或空格,視為沒有值。

相關 API:RequiredValidator

ValueLengthValidator

驗證 Value 的長度是否符合指定範圍。

相關 API:ValueLengthValidator

BulkValidator

批量驗證容器,可包含多個驗證器。參數 isStoppedIfFail 可控制驗證不通過時,是否繼續後續驗證。

相關 API:BulkValidator

型別驗證

提供驗證值是否可轉型成特定型別,及最大值和最小值驗證。

IntegerValidator

整數和極限值驗證,資料型別為 long。

參數:

  • allowedThousands:是否允許千分位符號

相關 API:IntegerValidator

NumberValidator

數值和極限值驗證,資料型別為 decimal。

參數:

  • allowedThousands:是否允許千分位符號

相關 API:NumberValidator

DateTimeValidator

日期和極限值驗證,資料型別為 DateTime。

相關 API:DateTimeValidator

比較驗證

CompareValidator

比較兩欄位的值是否相等。

相關 API:CompareValidator

IntegerLessThanValidator

整數欄位比較,Value 必須小於比較的值。

參數:

  • allowedEqual:設為 true 時,可以等於比較值

相關 API:IntegerLessThanValidator

NumberLessThanValidator

數值欄位比較,Value 必須小於比較的值。

參數:

  • allowedEqual:設為 true 時,可以等於比較值

相關 API:NumberLessThanValidator

DateTimeLessThanValidator

日期欄位比較,Value 必須小於比較的值。

參數:

  • allowedEqual:設為 true 時,可以等於比較值

相關 API:DateTimeLessThanValidator

格式驗證

RegexValidator

使用正規表示式驗證 Value。

相關 API:RegexValidator

EmailValidator

Email 格式驗證。

相關 API:EmailValidator

MobilePhoneValidator

手機格式驗證。

參數:

  • MobilePhoneFormats:可指定允許的手機號碼格式

相關 API:MobilePhoneValidator

IdCardValidator

身分證驗證。

參數:

  • IdCardTypes:設定驗證允許格式,包括:
    • 國民身分證號
    • 臺灣地區居留證統一證號
    • 外僑居留證統一證號
    • 遊民證號
    • 新式外來人口統一證號

預設允許全部格式。

相關 API:IdCardValidator

CreditCardValidator

信用卡號碼驗證。

相關 API:CreditCardValidator

UrlValidator

URL 格式驗證。

相關 API:UrlValidator

IPAddressValidator

IP 位址驗證。

參數:

  • IPAddressTypes:可指定允許的 IP 類型(IPv4、IPv6 或兩者)

相關 API:IPAddressValidator

Boolean 驗證

TrueAssertValidator

當條件為 true 時,驗證通過。

特色:參數可使用 Func<bool> 將條件式延後到 Validate() 時執行。

相關 API:TrueAssertValidator

FalseAssertValidator

當條件為 false 時,驗證通過。

特色:參數可使用 Func<bool> 將條件式延後到 Validate() 時執行。

相關 API:FalseAssertValidator

重要注意事項

Important

除了 RequiredValidator、BulkValidator 和 Boolean 驗證外,當 Value 為 null、空字串或空格時,皆視為驗證通過。

這意味著如果您需要驗證必填欄位,必須同時使用 RequiredValidator 和其他型別驗證器。

範例

查看 使用範例 了解如何在實際應用中使用這些驗證器。