Value プロパティ (GcMask)

コントロール内の入力文字のみ（リテラル文字列以外）を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property Value As String

public string Value {get; set;}

例外

例外	解説
System.ArgumentException	Formatプロパティで設定した書式で許可されない文字列が設定されました。

解説

Valueプロパティは、リテラル文字列を除いたコントロール内の文字列を設定します。Valueプロパティが変更されると、その変更はDisplayText とTextプロパティにも適用されます。

Valueプロパティに設定する文字は、Format.Patternプロパティで指定したリテラル文字列を除いた入力マスクと一致させる必要があります。一致しない場合、エラーが発生します。また、Formatプロパティを変更すると、Valueプロパティは自動的に空の文字列に設定されます。

使用例

次のサンプルコードは、郵便番号の書式を設定してコードで値を設定する方法を示します。

Visual Basic
C#

GcMask1.Format.Pattern = "\D{3}-\D{4}"
GcMask1.Value = "9813205"

GcMask1.Format.Pattern = "\\D{3}-\\D{4}";
GcMask1.Value = "9813205";

参照

GcMask クラス
 GcMask メンバ