MESCIUS SPREAD for Windows Forms 15.0J
ValidateMode プロパティ (GcDateTime)

入力中にコントロールに適用される検証モードを取得または設定します。
構文
'宣言
 
Public Property ValidateMode As ValidateModeEx
public ValidateModeEx ValidateMode {get; set;}

プロパティ値

ValidateModeEx値の1つ。デフォルトはValidateModeEx.ValidateExです。
例外
例外解説
System.ComponentModel.InvalidEnumArgumentException プロパティに指定された値が有効な列挙値ではありません。
解説

ValidateModeプロパティがValidateModeEx.ValidateExに設定されている場合、コントロールはうるう年や存在しない日付値のチェックなどの厳密な検証を実行します。 また、ユーザーがデータを入力すると、自動文字フィルタリングとフィールド調整が行われます。 たとえば、うるう年の場合、入力マスクが「yyyy.MM.dd」に設定されていると、ユーザーは2003年2月29日を入力できなくなります。入力マスクが「dd.MM」に設定されている場合。 2003年2月29日に入力されたyyyy 'は、その年の最後の3つが入力されるとすぐに、29日から28日に自動的に調整されます。

このプロパティをValidateModeEx.Validateに設定すると、簡易的な検証が実行されます。この場合、各フィールドは個別に動作し、フィールド間の関連性は無視されます。たとえば、入力マスクが"yyyy.MM.dd"に設定されている場合、通常であれば日付時刻値として存在できない「2003年2月31日」のような日付をコントロールに入力できます。次の表に、ValidateModeEx.Validateモードを使用した場合の各フィールドの有効な範囲を示します。

フィールド 有効な範囲
yyyy 0 - 9999
yy 0 - 99
ee 0 - 99
MM 0 - 12
dd 0 - 31
HH 0 - 23
mm 0 - 59
ss 0 - 59

このプロパティをValidateModeEx.Validateに設定すると、簡易的な検証が実行されます。この場合、各フィールドは個別に動作し、フィールド間の関連性は無視されます。たとえば、入力マスクが"yyyy.MM.dd"に設定されている場合、通常であれば日付時刻値として存在できない「00年2月31日」のような日付をコントロールに入力できます。次の表に、ValidateModeExモードを使用した場合の各フィールドの有効な範囲を示します。

フィールド 有効な範囲
yyyy 0 - 9999
yy 0 - 99
ee 0 - 99
MM 0 - 99
dd 0 - 99
HH 0 - 99
mm 0 - 99
ss 0 - 99

このプロパティは、コントロールにデータを入力するときにのみ有効です。フォーカスがコントロールから離れると同時に日付時刻値が検証されます。

入力時に、「2003.__.01」のような不完全なデータや「2002.02.31」のような存在しない日付時刻値が入力された場合、Valueプロパティはnullを返します。

スピンアクションを実行すると、ValidateModeプロパティの任意のモードで日時値が継続されます。 スピンアクションの有効範囲は、上記の表に示すようにデータを入力する場合と同じです。
参照

GcDateTime クラス
GcDateTime メンバ

 

 


© MESCIUS inc. All rights reserved.