ValidationRule ValidationRule ValidationRule ValidationRule Class

定義

ユーザー入力の有効性を確認するためのカスタム規則を作成する方法を提供します。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
継承
ValidationRuleValidationRuleValidationRuleValidationRule
派生

次の例では、検証規則を実装する方法を示します。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
{
    private int _min;
    private int _max;

    public AgeRangeRule()
    {
    }

    public int Min
    {
        get { return _min; }
        set { _min = value; }
    }

    public int Max
    {
        get { return _max; }
        set { _max = value; }
    }

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

        try
        {
            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 + ".");
        }
        else
        {
            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() ValidationRule() ValidationRule() ValidationRule()

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

ValidationRule(ValidationStep, Boolean) ValidationRule(ValidationStep, Boolean) ValidationRule(ValidationStep, Boolean) 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.

プロパティ

ValidatesOnTargetUpdated ValidatesOnTargetUpdated ValidatesOnTargetUpdated ValidatesOnTargetUpdated

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

ValidationStep ValidationStep ValidationStep ValidationStep

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

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
Validate(Object, CultureInfo) Validate(Object, CultureInfo) Validate(Object, CultureInfo) Validate(Object, CultureInfo)

派生クラスでオーバーライドされると、値の検証チェックを行います。When overridden in a derived class, performs validation checks on a value.

Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase) Validate(Object, CultureInfo, BindingExpressionBase)

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

Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup) Validate(Object, CultureInfo, BindingGroup)

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

適用対象

こちらもご覧ください