1.功能
ValidationSummary控件本身并不能驗證數據,但可以用來顯示其他驗證控件的驗證結果,換言之ValidationSummary控件是用來顯示頁面上各種驗證控件顯示的出錯信息,在使用該控件之前需要先設置好其他驗證控件的ErrorMessage屬性。
2.屬性
ValidationSummary控件部分常用屬性及說明如表1所示。
表1 ValidationSummary控件常用的屬性
屬性 |
描述 |
HeaderText |
該屬性獲取或設置顯示在摘要上方的標題文本 |
DisplayMode |
該屬性獲取或設置驗證摘要的顯示模式 |
ShowMessageBox |
是否以彈出方式顯示每個被驗證控件的錯誤信息 |
ShowSummary |
是否使用錯誤匯總信息 |
EnableClientScript |
是否使用客戶端驗證,系統默認值為True |
Validate |
執行驗證并且更新IsValid屬性 |
下面對比較重要的屬性進行詳細介紹。
(1)HeaderText屬性
該屬性獲取或設置顯示在摘要上方的標題文本。
語法:
publicstringHeaderText{get;set;} |
屬性值:
顯示在摘要上方的標題文本。默認為 String.Empty。
例如:設置ValidationSummary控件的標題為“錯誤信息總匯” ,代碼如下:
ValidationSummary1.HeaderText="錯誤信息總匯"; |
(2)DisplayMode屬性
該屬性獲取或設置驗證摘要的顯示模式。
語法:
ValidationSummaryDisplayModeDisplayMode{get;set;} |
屬性值:
ValidationSummaryDisplayMode值之一。默認為 BulletList。ValidationSummaryDisplayMode值是一個枚舉類型值,表示指定 ValidationSummary 控件使用的驗證摘要顯示模式。ValidationSummaryDisplayMode枚舉值及說明如表2所示。
表2 ValidationSummaryDisplayMode枚舉值及說明
格舉值 |
說明 |
BulletList |
顯示在項目符號列表中的驗證摘要 |
List |
顯示在列表中的驗證摘要 |
SingleParagraph |
顯示在單個段落內的驗證摘要 |
例如:設置ValidationSummary的顯示模式為項目符號列表,代碼如下:
this.ValidationSummary1.DisplayMode=ValidationSummaryDisplayMode.BulletList; |
(3)ShowMessageBox屬性
該屬性獲取或設置一個值,該值指示是否在消息框中顯示驗證摘要。
語法:
publicboolShowMessageBox{get;set;} |
屬性值:
如果在消息框中顯示驗證摘要,則為 true;否則為 false。默認為 false。
(4)ShowSummary屬性
該屬性獲取或設置一個值,該值指示是否內聯顯示驗證摘要。
語法:
publicboolShowSummary{get;set;} |
屬性值:
如果內聯顯示驗證摘要,則為 true;否則為 false。默認為 true。
注意:如果 ShowMessageBox 和 ShowSummary 屬性都設置為 true,則在消息框和網頁上都顯示驗證摘要。
ValidationSummary控件常用方法,事件同RequiredFieldValidator控件類似。
3.典型實例
本例實現了使用ValidationSummary控件的相關屬性,來顯示頁面中所有驗證錯誤的信息。
代碼如下。
protectedvoidPage_Load(objectsender,EventArgse){
RequiredFieldValidator1.ControlToValidate="TextBox1";//設置要驗證控件的ID RequiredFieldValidator1.ErrorMessage="用戶名稱不能為空";//設置錯誤信息 RequiredFieldValidator1.Display=ValidatorDisplay.None;//設置錯誤信息顯示模式 RequiredFieldValidator2.ControlToValidate="TextBox2";//設置要驗證控件的ID RequiredFieldValidator2.ErrorMessage="登錄密碼不能為空";//設置錯誤信息 RequiredFieldValidator2.Display=ValidatorDisplay.None;//設置錯誤信息顯示模式 ValidationSummary1.HeaderText="登錄錯誤信息提示:";//設置ValidationSummary控件的標題 ValidationSummary1.DisplayMode=ValidationSummaryDisplayMode.BulletList;//設置錯誤信息顯示模式 ValidationSummary1.ShowMessageBox=true;//設置是否用對話框來顯示錯誤信息 ValidationSummary1.ShowSummary=true;//設置是否在網頁上顯示錯誤信息 } |
新聞熱點
疑難解答
圖片精選