ValidateMode プロパティ (GcDateTimeCellType)

Visual Basic
C#

'Declaration
 
Public Property ValidateMode As ValidateModeEx

'使用法
 
Dim instance As GcDateTimeCellType
Dim value As ValidateModeEx
 
instance.ValidateMode = value
 
value = instance.ValidateMode

public ValidateModeEx ValidateMode {get; set;}

プロパティ値

ValidateModeEx 列挙値の１つ。既定値は ValidateModeEx.ValidateEx です。

例外	説明
System.ComponentModel.InvalidEnumArgumentException	プロパティに指定された値が有効な列挙値ではありません。

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

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

フィールド	有効な範囲
yyyy	1～9999
yy	0～99
ee	1～99
MM	1～12
dd	1～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」のような存在しない日付時刻値が入力された場合、GcDateTime.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 メンバ