Validation.Errors 附加屬性

定義

取得綁定元素上所有活躍 ValidationError 物件的集合。

see GetErrors
see GetErrors
see GetErrors

備註

應用程式無法修改本收藏的內容。 請參閱範例章節,了解如何使用這個附加屬性。

WPF 資料綁定模型讓你能與你的ValidationRules物件產生關聯Binding。 驗證發生在綁定目標到綁定來源值傳輸過程中,然後才呼叫轉換器。 以下描述驗證過程:

  1. 當值從目標屬性轉移到來源屬性時,資料綁定引擎會先移除 ValidationError 可能已加入 System.Windows.Controls.Validation.Errors 綁定元素附加屬性的任何值。 接著檢查是否有自訂 ValidationRule的 s, Binding這時它會呼叫 Validate 每個 ValidationRules 的方法,直到其中一個出錯,或全部通過為止。

  2. 一旦有自訂規則未通過,綁定引擎會建立一個 ValidationError 物件並將其加入 System.Windows.Controls.Validation.Errors 綁定元素的集合中。 當 System.Windows.Controls.Validation.Errors 不空時, System.Windows.Controls.Validation.HasError 元素的附加性質被設定為 true。 此外,如果 NotifyOnValidationErrorBinding 屬性設定為 true,則繫結引擎會針對元素引發 System.Windows.Controls.Validation.Error 附加事件。

  3. 若所有規則通過,綁定引擎接著呼叫轉換器(若有轉換器)。

  4. 如果轉換器通過,綁定引擎會呼叫來源屬性的設定器。

  5. 如果綁定有 ExceptionValidationRule 關聯,且在第 4 步拋出例外,綁定引擎會檢查是否有 UpdateSourceExceptionFilter。 你可以選擇使用 UpdateSourceExceptionFilter 回調來提供自訂的處理程序來處理例外。 若 未指定 UpdateSourceExceptionFilteraBinding,綁定引擎會建立帶有例外的 aValidationError,並將其加入System.Windows.Controls.Validation.Errors綁定元素的集合中。

另外請注意,有效的值轉移(目標到來源或來源到目標)會清除 Validation.Errors attached 屬性。

關於此性質在情境下的 MultiBinding 行為資訊,請參見 ValidationError

欲了解更多資訊,請參閱 資料綁定概覽中的「資料驗證」。

XAML 文字使用

請參閱備註。 這個 Errors 集合本身無法使用者設定,但你可以在 XAML 的控制範本定義中使用它。

相依財產資訊

Item 價值觀
識別碼欄位 ErrorsProperty
元資料屬性設為 true IsNotDataBindable

適用於