【功能說明】

用途：使用於Web網頁中，此元件專門用來處理資料的檢核功能即輸入資料的合法性檢查。

【元件屬性】

(ID)(名稱)(string)

元件名稱，用於識別該元件。

DataSourceID(資料源)(string)

所要檢核的對應資料源，指向一個WebDataSource。

ValidateActive(啟用檢核)(bool)

指示該WebValidate元件是否被啟用，注意，如果為False，則整個資料檢核會失效。

DuplicateCheck(重複檢查)(bool)

用來設定是否在WebDataSource存檔前去做資料重複檢查功能，如果資料鍵值重複系統會自動提出警告訊息並終止新增動作，此功能必須搭配後端InfoCommand的KeyFields設定，否則WebDataSource無法得知KeyFields為誰。

DuplicateCheckMode(重複檢查模式)(enum)

用來定義重複檢查模式，可以定義為ByLocal 與ByWhere，如果是ByLocal則會在WebDataSource資料範圍內檢查重複的鍵值，注意WebDataSet內的PackedRecord設定，如果PackedRecord不為-1(全部下載)時，則ByLocal會有誤差，一般ByLocal用在Master/Detail的Detail的重複檢查；ByWhere則會在存檔前去後端以Where的指定去尋找是否有重複資料。

ValidateStyle(enum)

枚舉類型屬性，指示未通過資料檢查時所提示資訊的方式，ShowLabel 以label的形式提示；ShowDialog 以Dialog的形式提示。

Fields(collection)

設置所選資料源中要進行資料合法性檢查的列，包括以下屬性：

FieldName(欄位名稱)(string)：要檢查的欄位名稱。

CheckNull(空白檢查)(bool)：設定該欄位是否要檢查是否為空。

CheckRangeFrom(範圍檢查最小值)(string)：設定該欄位檢查條件的

最小值。

CheckRangeTo(範圍檢查最大值)(string)：設定該欄位檢查條件的最

大值。

Vaildate(自定檢核程式)(string)：設定該欄位的合法性檢查規則，並

在不符合規則時給予提示，因為時合法性檢查，所以這裏只能使用函

數，並且返回bool值來控制是否合法。

WarningMsg(警告訊息)(string)：當Validate合法性檢查沒有通過時，

將提示給User的訊息。

ValidateLabelLink(對應的標籤元件)(string)：選擇一個Label(一般為

顯示該欄位名稱的Label)，用於方便提示該欄位存在資料檢查，此設

定必須和ValidateChar或ValidateColor合用。

ValidateChar(檢核欄位字元)(string)

Fields屬性中的ValidateLabelLink所選Label的Text前加入所設置的Char，用來提示用戶該欄位存在資料檢查，同樣使用於WebGridView,WebDetailsView,WebFormView。

ValidateColor(檢核欄位顏色)(Color)

設置Fields屬性中的ValidateLabelLink所選Label的BackColor，用來提示用戶該欄位存在資料檢查。

【事件】

此組件無事件。

【功能函數】

此元件無功能函數。

【其它說明】

本元件內的檢查欄位如果只設定CheckRangeForm或CheckRangeTo，即可達到單向的範圍檢查，如可達到 "必須大於等於"與"必須小於等於"的功能，系統訊息也會自動匹配。

訊光科技系統股份有限公司