ValidationRule.Validate メソッド

定義

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

オーバーロード

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.

Validate(Object, CultureInfo)

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

public:
 abstract System::Windows::Controls::ValidationResult ^ Validate(System::Object ^ value, System::Globalization::CultureInfo ^ cultureInfo);
public abstract System.Windows.Controls.ValidationResult Validate (object value, System.Globalization.CultureInfo cultureInfo);
abstract member Validate : obj * System.Globalization.CultureInfo -> System.Windows.Controls.ValidationResult
Public MustOverride Function Validate (value As Object, cultureInfo As CultureInfo) As ValidationResult

パラメーター

value
Object

チェックするバインド ターゲットからの値。The value from the binding target to check.

cultureInfo
CultureInfo

このルールで使用するカルチャ。The culture to use in this rule.

戻り値

ValidationResult

ValidationResult オブジェクト。A ValidationResult object.

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

注釈

ValidationRuleカスタム検証規則を作成するために、クラスのサブクラスを作成する場合は、このメソッドを実装する必要があります。You must implement this method when you create a subclass of the ValidationRule class in order to create a custom validation rule.

データバインディングエンジンは、バインディングターゲットプロパティ (ユーザー入力から基になるデータ) に値を転送するたびに、その ValidationRules バインディングに対して定義されているがあるかどうかをチェックします。Each time the data binding engine transfers a value from the binding target property (from user input) to the binding source property (the underlying data), it checks whether any ValidationRules are defined for that binding. ValidationRulesがバインディングに対して定義されている場合、エンジンは、 Validate ValidationRule そのいずれかがエラーを検出するか、すべてのメソッドが成功するまで、それぞれのメソッドを呼び出します。If ValidationRules are defined for the binding, the engine calls the Validate method on each ValidationRule until one of them finds an error or until all of them pass.

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

こちらもご覧ください

適用対象

製品 Introduced

Validate(Object, CultureInfo, BindingExpressionBase)

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

public:
 virtual System::Windows::Controls::ValidationResult ^ Validate(System::Object ^ value, System::Globalization::CultureInfo ^ cultureInfo, System::Windows::Data::BindingExpressionBase ^ owner);
public virtual System.Windows.Controls.ValidationResult Validate (object value, System.Globalization.CultureInfo cultureInfo, System.Windows.Data.BindingExpressionBase owner);
abstract member Validate : obj * System.Globalization.CultureInfo * System.Windows.Data.BindingExpressionBase -> System.Windows.Controls.ValidationResult
override this.Validate : obj * System.Globalization.CultureInfo * System.Windows.Data.BindingExpressionBase -> System.Windows.Controls.ValidationResult
Public Overridable Function Validate (value As Object, cultureInfo As CultureInfo, owner As BindingExpressionBase) As ValidationResult

パラメーター

value
Object

チェックするバインド ターゲットからの値。The value from the binding target to check.

cultureInfo
CultureInfo

このルールで使用するカルチャ。The culture to use in this rule.

owner
BindingExpressionBase

検証規則を使用するバインディング式。The binding expression that uses the validation rule.

戻り値

ValidationResult

ValidationResult オブジェクト。A ValidationResult object.

適用対象

製品 Introduced

Validate(Object, CultureInfo, BindingGroup)

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

public:
 virtual System::Windows::Controls::ValidationResult ^ Validate(System::Object ^ value, System::Globalization::CultureInfo ^ cultureInfo, System::Windows::Data::BindingGroup ^ owner);
public virtual System.Windows.Controls.ValidationResult Validate (object value, System.Globalization.CultureInfo cultureInfo, System.Windows.Data.BindingGroup owner);
abstract member Validate : obj * System.Globalization.CultureInfo * System.Windows.Data.BindingGroup -> System.Windows.Controls.ValidationResult
override this.Validate : obj * System.Globalization.CultureInfo * System.Windows.Data.BindingGroup -> System.Windows.Controls.ValidationResult
Public Overridable Function Validate (value As Object, cultureInfo As CultureInfo, owner As BindingGroup) As ValidationResult

パラメーター

value
Object

チェックするバインド ターゲットからの値。The value from the binding target to check.

cultureInfo
CultureInfo

このルールで使用するカルチャ。The culture to use in this rule.

owner
BindingGroup

検証規則を使用するバインディング グループ。The binding group that uses the validation rule.

戻り値

ValidationResult

ValidationResult オブジェクト。A ValidationResult object.

適用対象

製品 Introduced