ExceptionValidationRule クラス

定義

バインディング ソースのプロパティの更新中にスローされる例外をチェックする規則を表します。

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
継承
ExceptionValidationRule

プロパティは ValidationRules 、 オブジェクトの ValidationRule コレクションを受け取ります。 次の例では、 をバインディング ターゲット プロパティとして、バインディング StartPrice ソース プロパティとして (整数) を使用TextBox.Textします。 ユーザーが整数に変換できない値を入力すると、例外がスローされ、 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)

適用対象

こちらもご覧ください