共用方式為


Validation.Errors 附加屬性

定義

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

see GetErrors
see GetErrors
see GetErrors

備註

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

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

  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。 此外,若 NotifyOnValidationError 的屬性 Binding 設為 true,綁定引擎會將 System.Windows.Controls.Validation.Error 該元素上的附加事件提升。

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

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

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

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

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

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

XAML 文字使用

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

相依財產資訊

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

適用於