入力文字列の検証（PreValidation）

入力文字列の検証は、PreValidation プロパティによって制御されます。PreValidation クラスを使用して、ワイルドカードパターン文字列または正規表現文字列のいずれかの検証規則を指定できます。すべての規則（文字列）は、PatternString プロパティで指定します。複数の規則（サブ文字列）を指定する場合は、それらを ItemSeparator で区切ります（デフォルトは「|」）。

PreValidation プロパティは、PatternString がどのように解釈されるかを定義します。

値	説明
ExactList	PatternString には、有効な値が ItemSeparator で区切って指定されます。
PreValidatingEvent	検証には PreValidating イベントが使用されます。
ワイルドカード	PatternString には、ワイルドカードパターンが ItemSeparator で区切って指定されます。パターン内では、?（任意の１文字）、#（任意の１桁）、*（０個以上の文字）、\（エスケープ）の各文字が予約されています。また、PreValidation プロパティを使用して、カスタムパターン文字を定義することもできます。
RegexPattern	PatternString には、正規表現が指定されます。

PreValidatingEvent オプションを使用すると、PreValidating イベントのコードで入力文字列を検証できます。詳細については、イベントの説明を参照してください。

RegexPattern オプションを指定して正規表現を使用する場合は、RegexOptions プロパティを使用して、正規表現の機能を変更するフラグを設定する必要がある場合があります。

メモ： PreValidation（入力文字列の検証）は、DateTimeInput と NumericInput の各モードでは使用されません。DateTimeInput モードまたは NumericInput モードが有効な場合は、PostValidation（型付きの値の検証）が実行されます。

サンプル

以下の例で、Validation プロパティと PatternString プロパティがどのように解釈されるかを説明します。

Validation プロパティが ExactList に、PatternString プロパティが「red|green|blue」に設定されている場合：入力文字列は、許可されている３つの値、つまり「red」、「green」、「blue」のいずれかである必要があります。CaseSensitive が False に設定されている場合は、大文字小文字が区別されません。
Validation プロパティが Wildcards に、PatternString プロパティが「(412)*」に設定されている場合：入力文字列の先頭は「(412)」である必要があります。CaseSensitive が False に設定されている場合は、大文字小文字が区別されません。
Validation プロパティが RegexPattern に、PatternString が「[0-9]*」に設定されている場合：入力文字列は１桁以上の数値です。