ValidationRule クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザー入力の有効性を検査するためのカスタム ルールを作成する方法を提供します。
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) |
値の検証チェックを実行します。 |
適用対象
こちらもご覧ください
.NET