Share via


基底驗證控制項屬性

下表所列出的屬性適用於所有驗證控制項。

屬性

ControlToValidate

驗證控制項將會評估的輸入控制項的程式設計 ID。 如果這不是合法的 ID,會擲回例外狀況。

Display

指定的驗證控制項之顯示行為。 這個屬性可以是下列其中一個值:

None:驗證控制項不會內嵌 (Inline) 顯示。 當您只想在 ValidationSummary 控制項中顯示錯誤訊息時,就可以使用這個選項。

Static:如果驗證失敗,驗證控制項會顯示錯誤訊息。 即使輸入控制項通過驗證,在網頁上還是會為錯誤訊息配置空間。 當驗證控制項顯示其錯誤訊息時,網頁的配置並不會改變。 這是因為網頁的配置是靜態的,相同輸入控制項的多個驗證控制項必須在網頁上佔用不同的實體位置。

Dynamic:如果驗證失敗,驗證控制項會顯示錯誤訊息。 當驗證失敗時,在網頁上會動態地配置錯誤訊息的空間。 這可以讓多個驗證控制項在網頁上共用相同的實體位置。

NoteNote
因為驗證控制項的空間是動態建立的,所以網頁的實體配置會變更。為了不讓網頁配置在驗證控制項顯示時有所變更,含有驗證控制項的 HTML 項目必須調整大小,大到足以容納驗證控制項的大小上限。

EnableClientScript

指示是否啟用用戶端驗證。 將 EnableClientScript 屬性設為 false,可以在支援這個功能的瀏覽器上停用用戶端驗證。

Enabled

指示是否啟用驗證控制項。 將這個屬性設為 false,可以避免驗證控制項驗證輸入控制項。

ErrorMessage

如果驗證失敗,便在 ValidationSummary 控制項中顯示的錯誤訊息。 如果未設定驗證控制項的 Text 屬性,當驗證失敗時,這個文字也會顯示在驗證控制項中。 ErrorMessage 屬性通常用於為驗證控制項和 ValidationSummary 控制項提供不同的訊息。

NoteNote
這個屬性不會將特殊字元轉換成 HTML 實體。例如,小於字元 (<) 不會被轉換成 &lt;。這可以讓您在這個屬性的值中封入 HTML 項目,例如 <img> 項目。

ForeColor

指定驗證失敗時,要用以顯示內嵌訊息的色彩。

IsValid

表示 ControlToValidate 屬性所指定的輸入控制項是否會判斷為有效。

SetFocusOnError

表示在驗證失敗時,焦點是否設定到由 ControlToValidate 屬性所指定的控制項。

Text

如果設定這個屬性,當驗證失敗時,這個訊息會顯示在驗證控制項中。 如果未設定這個屬性,在 ErrorMessage 屬性中指定的文字會顯示在控制項中。

ValidationGroup

指定這個驗證控制項所屬之驗證群組的名稱。

請參閱

參考

BaseValidator

其他資源

驗證伺服器控制項語法