ValidateMode プロパティ (GcDateTimeCellType)

Visual Basic
C#

'宣言
 
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に設定されている場合、コントロールは検証を実行しません。フィールドは、ValidateModeEx.Validateに設定されている場合と同じように独立して動作します。たとえば、入力マスクが「yyyy.MM.dd」に設定されている場合、コントロールでは、日時値ではない「0000.00.00」を入力できます。次の表は、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プロパティの任意のモードで日時値が継続されます。スピンアクションの有効範囲は、上記の表に示すようにデータを入力する場合と同じです。

次のサンプルコードは、ValidateMode プロパティを使用します。

C#
VB.NET

GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType datecell = new GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType();
datecell.ValidateMode = GrapeCity.Win.Spread.InputMan.CellType.ValidateModeEx.ValidateNone;      
fpSpread1.Sheets[0].Cells[0, 0].CellType = datecell;

Dim datecell As New GrapeCity.Win.Spread.InputMan.CellType.GcDateTimeCellType()
datecell.ValidateMode = GrapeCity.Win.Spread.InputMan.CellType.ValidateModeEx.ValidateNone
fpSpread1.Sheets(0).Cells(0, 0).CellType = datecell

GcDateTimeCellType クラス
 GcDateTimeCellType メンバ