WebValidate

【功能說明】

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

【元件屬性】

ID( 名稱 )(string)

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

DataSourceID ( 資料源 )(string)

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

DataMember ( 資料成員 ) (string)

對應的資料表名稱，此可以對應到一個要執行檢核功能的 WebDataSet 資料集中的某一個 Table ( 因為一個 WebDataSet 會有多個 Table 的內容 ) 。

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 , 用來提示用戶該欄位存在資料檢查。

【事件】

此元件無事件。

【功能函數】

此元件無功能函數。

【其他說明】

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