ExceptionValidationRule 類別

定義

命名空間:

System.Windows.Controls

組件:

PresentationFramework.dll

表示規則，這個規則會檢查繫結來源屬性更新期間所擲回的例外狀況。

public ref class ExceptionValidationRule sealed : System::Windows::Controls::ValidationRule

public sealed class ExceptionValidationRule : System.Windows.Controls.ValidationRule

type ExceptionValidationRule = class
    inherit ValidationRule

Public NotInheritable Class ExceptionValidationRule
Inherits ValidationRule

繼承

Object

ValidationRule

ExceptionValidationRule

範例

屬性 ValidationRules 會接受 物件的集合 ValidationRule 。 下列範例使用 TextBox.Text 做為系結目標屬性， (StartPrice 整數) 做為系結來源屬性。 當使用者輸入無法轉換成整數的值時，會擲回例外狀況，這會導致 ExceptionValidationRule 使目標值失效。

<TextBox Name="StartPriceEntryForm" Grid.Row="2" Grid.Column="1"
    Style="{StaticResource textStyleTextBox}" Margin="8,5,0,5">
  <TextBox.Text>
    <Binding Path="StartPrice" UpdateSourceTrigger="PropertyChanged">
      <Binding.ValidationRules>
        <ExceptionValidationRule />
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

根據預設，當發生驗證錯誤時，會出現 TextBox 紅色框線。 您可以選擇性地撰寫自訂 ErrorTemplate ，以指定要在發生驗證錯誤時通知使用者的方式。

如需資料驗證的詳細資訊，請參閱 資料系結概觀。

如需完整的範例，請參閱 資料系結示範。

備註

WPF 資料系結模型可讓您與 物件產生 Binding 關聯 ValidationRules 。 類別 ExceptionValidationRule 是內建規則，會檢查在系結來源屬性更新期間擲回的例外狀況。 您可以提供自訂邏輯來指定系結引擎如何使用 UpdateSourceExceptionFilterCallback 來處理這些例外狀況。 如需詳細資訊，請參閱UpdateSourceExceptionFilter。

明確設定 ExceptionValidationRule 的替代語法是在您的 Binding 或 MultiBinding 物件上將 ValidatesOnExceptions 屬性設定為 true。

您可以建立衍生自 ValidationRule 的類別來建立自訂規則。 如需資料驗證的詳細資訊和詳細討論，請參閱 資料系結概觀。

建構函式

ExceptionValidationRule()

初始化 ExceptionValidationRule 類別的新執行個體。

屬性

ValidatesOnTargetUpdated	取得或設定值，這個值表示是否在 Binding 的目標更新值執行驗證規則。 (繼承來源 ValidationRule)
ValidationStep	取得或設定執行驗證規則的時機。 (繼承來源 ValidationRule)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Validate(Object, CultureInfo)	在值上執行驗證檢查。
Validate(Object, CultureInfo, BindingExpressionBase)	在值上執行驗證檢查。 (繼承來源 ValidationRule)
Validate(Object, CultureInfo, BindingGroup)	在值上執行驗證檢查。 (繼承來源 ValidationRule)

另請參閱

• ValidationRule
• DataErrorValidationRule