ValidationException 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表在驗證資料欄位時，當使用該 ValidationAttribute 類別時所發生的例外。
public ref class ValidationException : Exceptionpublic class ValidationException : Exception[System.Serializable]
public class ValidationException : Exceptiontype ValidationException = class
inherit Exception[<System.Serializable>]
type ValidationException = class
inherit ExceptionPublic Class ValidationException
Inherits Exception- 繼承
- 屬性
備註
當輸入值與預期的資料型別、範圍或資料欄位模式不符時，就會發生驗證例外。 例如，如果使用者在預期某個 DateTime 值的資料欄位輸入整數值，就會發生驗證異常。
這個類別使用 該 ValidationAttribute 類別來自訂驗證。 若發生驗證錯誤，則拋出 A ValidationException 。 當 Validate 方法被呼叫時，會拋出例外。 驗證過程中拋出的所有例外都包含在集合 InnerExceptions 中。 你可以透過在集合 InnerExceptions 中遍歷來取得每個驗證例外。
建構函式
| 名稱 | Description |
|---|---|
| ValidationException() |
利用系統產生的錯誤訊息初始化該類別的新 ValidationException 實例。 |
| ValidationException(SerializationInfo, StreamingContext) |
使用序列化資料初始化類別的新實例 ValidationException 。 |
| ValidationException(String, Exception) |
利用指定的錯誤訊息及一組內部例外實例初始化該 ValidationException 類別的新實例。 |
| ValidationException(String, ValidationAttribute, Object) |
使用指定的錯誤訊息、驗證屬性及當前例外值初始化該類別的新實例 ValidationException 。 |
| ValidationException(String) |
使用指定的錯誤訊息初始化該類別的新實例 ValidationException 。 |
| ValidationException(ValidationResult, ValidationAttribute, Object) |
透過使用驗證結果、驗證屬性及當前例外值來初始化該類別的新 ValidationException 實例。 |
屬性
| 名稱 | Description |
|---|---|
| Data |
取得索引鍵/值組的集合，提供例外狀況的其他使用者定義資訊。 (繼承來源 Exception) |
| HelpLink |
取得或設定與這個例外狀況相關聯的說明檔連結。 (繼承來源 Exception) |
| HResult |
取得或設定 HRESULT，這是指派給特定例外狀況的編碼數值。 (繼承來源 Exception) |
| InnerException |
會取得 Exception 造成目前例外的實例。 (繼承來源 Exception) |
| Message |
取得描述目前例外狀況的訊息。 (繼承來源 Exception) |
| Source |
取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception) |
| StackTrace |
取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception) |
| TargetSite |
取得擲回目前例外狀況的方法。 (繼承來源 Exception) |
| ValidationAttribute |
取得觸發此異常的類別實例 ValidationAttribute 。 |
| ValidationResult |
取得 ValidationResult 描述驗證錯誤的實例。 |
| Value |
取得導致 ValidationAttribute 類別觸發此例外的物件值。 |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的 物件是否等於目前的物件。 (繼承來源 Object) |
| GetBaseException() |
當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
取得例外的資訊並將其加入 SerializationInfoEnumerator 物件。 |
| GetObjectData(SerializationInfo, StreamingContext) |
在衍生類別中覆寫時，使用例外狀況的相關信息來設定 SerializationInfo。 (繼承來源 Exception) |
| GetType() |
取得目前實例的運行時間類型。 (繼承來源 Exception) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
建立並傳回目前例外狀況的字串表示。 (繼承來源 Exception) |
事件
| 名稱 | Description |
|---|---|
| SerializeObjectState |
發生於例外狀況串行化以建立例外狀況狀態物件，其中包含例外狀況的串行化數據。 (繼承來源 Exception) |