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
{
    public int Min { get; set; }
    public int Max { get; set; }
    
    public AgeRangeRule()
    {
    }

    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}.");
        }
        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.

適用対象

こちらもご覧ください