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;//設置是否在網頁上顯示錯誤信息 } |
新聞熱點
疑難解答
圖片精選
