ValidationRule クラス


ユーザー入力の有効性を検査するためのカスタム ルールを作成する方法を提供します。Provides a way to create a custom rule in order to check the validity of user input.

public ref class ValidationRule abstract
public abstract class ValidationRule
type ValidationRule = class
Public MustInherit Class ValidationRule

検証規則を実装する方法を次の例に示します。The following example shows how to implement a validation rule. 数値以外の文字が含まれている場合、または下限と上限の範囲外の場合、入力値は無効です。The input value is invalid if it contains non-numeric characters or if it is outside the lower and upper bounds. 返されたの値 ValidationResult が無効である場合、 ErrorContent プロパティは適切なエラーメッセージに設定され、 IsValid プロパティはに設定され false ます。If the value of the returned ValidationResult is invalid, the ErrorContent property is set to the appropriate error message and the IsValid property is set to false.

完全な例については、「 方法: バインディング検証を実装する」を参照してください。For the complete example, see How to: Implement Binding Validation.

public class AgeRangeRule : ValidationRule
    public int Min { get; set; }
    public int Max { get; set; }
    public AgeRangeRule()

    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
        int age = 0;

            if (((string)value).Length > 0)
                age = Int32.Parse((String)value);
        catch (Exception e)
            return new ValidationResult(false, $"Illegal characters or {e.Message}");

        if ((age < Min) || (age > Max))
            return new ValidationResult(false,
              $"Please enter an age in the range: {Min}-{Max}.");
        return ValidationResult.ValidResult;


WPFWPFデータバインディングモデルを使用すると、をバインドオブジェクトに関連付けることができ ValidationRules ます。When you use the WPFWPF data binding model, you can associate ValidationRules with your binding object. カスタム規則を作成するには、このクラスのサブクラスを作成し、メソッドを実装し Validate ます。To create custom rules, make a subclass of this class and implement the Validate method. 必要に応じて、組み込みのを使用します ExceptionValidationRule 。これは、ソースの更新中にスローされた例外をキャッチします。または、 DataErrorValidationRule ソースオブジェクトの実装によって発生したエラーをチェックするを使用し IDataErrorInfo ます。Optionally, use the built-in ExceptionValidationRule, which catches exceptions that are thrown during source updates, or the DataErrorValidationRule, which checks for errors raised by the IDataErrorInfo implementation of the source object.

バインディングエンジンは、バインディング ValidationRule ターゲットプロパティ値である入力値をバインディングソースプロパティに転送するたびに、バインディングに関連付けられている各をチェックします。The binding engine checks each ValidationRule that is associated with a binding every time it transfers an input value, which is the binding target property value, to the binding source property.

データの検証の詳細については、「 データバインディングの概要」を参照してください。For detailed information about data validation, see Data Binding Overview.

ダイアログボックスでユーザーが指定したデータを検証する方法の詳細については、「ダイアログボックスの 概要」を参照してください。For information about how to validate user-provided data in a dialog box, see Dialog Boxes Overview.



ValidationRule クラスの新しいインスタンスを初期化します。Initializes a new instance of the ValidationRule class.

ValidationRule(ValidationStep, Boolean)

指定した検証手順と、ターゲットの更新時に検証規則を実行するかどうかを示す値を使用して、ValidationRule クラスの新規インスタンスを初期化します。Initializes a new instance of the ValidationRule class with the specified validation step and a value that indicates whether the validation rule runs when the target is updated.



Binding のターゲットが更新されたときに検証規則を実行するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the validation rule runs when the target of the Binding is updated.


検証規則を実行するタイミングを取得または設定します。Gets or sets when the validation rule runs.



指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)
Validate(Object, CultureInfo)

派生クラスによってオーバーライドされた場合、値に対して検証チェックを実行します。When overridden in a derived class, performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase)

値の検証チェックを実行します。Performs validation checks on a value.

Validate(Object, CultureInfo, BindingGroup)

値の検証チェックを実行します。Performs validation checks on a value.