ValidationRule クラス

定義

ユーザー入力の有効性を検査するためのカスタム ルールを作成する方法を提供します。

public ref class ValidationRule abstract
public abstract class ValidationRule
type ValidationRule = class
Public MustInherit Class ValidationRule
継承
ValidationRule
派生

検証規則を実装する方法を次の例に示します。 数値以外の文字が含まれている場合、または下限と上限の範囲外の場合、入力値は無効です。 返されたの値 ValidationResult が無効である場合、 ErrorContent プロパティは適切なエラーメッセージに設定され、 IsValid プロパティはに設定され false ます。

完全な例については、「 方法: バインディング検証を実装する」を参照してください。

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;
    }
}

注釈

WPF データバインディングモデルを使用すると、をバインドオブジェクトに関連付けることができ ValidationRules ます。 カスタム規則を作成するには、このクラスのサブクラスを作成し、メソッドを実装し Validate ます。 必要に応じて、組み込みのを使用します ExceptionValidationRule 。これは、ソースの更新中にスローされた例外をキャッチします。または、 DataErrorValidationRule ソースオブジェクトの実装によって発生したエラーをチェックするを使用し IDataErrorInfo ます。

バインディングエンジンは、バインディング ValidationRule ターゲットプロパティ値である入力値をバインディングソースプロパティに転送するたびに、バインディングに関連付けられている各をチェックします。

データの検証の詳細については、「 データバインディングの概要」を参照してください。

ダイアログボックスでユーザーが指定したデータを検証する方法の詳細については、「ダイアログボックスの 概要」を参照してください。

コンストラクター

ValidationRule()

ValidationRule クラスの新しいインスタンスを初期化します。

ValidationRule(ValidationStep, Boolean)

指定した検証手順と、ターゲットの更新時に検証規則を実行するかどうかを示す値を使用して、ValidationRule クラスの新規インスタンスを初期化します。

プロパティ

ValidatesOnTargetUpdated

Binding のターゲットが更新されたときに検証規則を実行するかどうかを示す値を取得または設定します。

ValidationStep

検証規則を実行するタイミングを取得または設定します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

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

派生クラスによってオーバーライドされた場合、値に対して検証チェックを実行します。

Validate(Object, CultureInfo, BindingExpressionBase)

値の検証チェックを実行します。

Validate(Object, CultureInfo, BindingGroup)

値の検証チェックを実行します。

適用対象

こちらもご覧ください