MaskedTextBox.Mask MaskedTextBox.Mask MaskedTextBox.Mask MaskedTextBox.Mask Property

定義

実行時に使用する入力マスクを取得または設定します。Gets or sets the input mask to use at run time.

public:
 property System::String ^ Mask { System::String ^ get(); void set(System::String ^ value); };
public string Mask { get; set; }
member this.Mask : string with get, set
Public Property Mask As String

プロパティ値

現在のマスクを表す StringA String representing the current mask. 既定値は、任意の入力を許可する空の文字列です。The default value is the empty string which allows any input.

例外

Mask プロパティに指定された文字列が有効なマスクではありません。The string supplied to the Mask property is not a valid mask. 無効なマスクには、印字不可能な文字を格納しているマスクが含まれます。Invalid masks include masks containing non-printable characters.

注釈

Maskは、 MaskedTextBoxクラスの既定のプロパティです。Mask is the default property for the MaskedTextBox class.

Maskは、次の表に示すように、1つまたは複数のマスク要素で構成される文字列である必要があります。Mask must be a string composed of one or more of the masking elements, as shown in the following table. によっMaskedTextBoxて使用されるマスク言語は、 MaskedTextProvider関連付けられているによって定義されます。The masking language used by MaskedTextBox is defined by its associated MaskedTextProvider. 標準プロバイダーでは、Visual Basic 6.0 のマスクエディットコントロールによって使用される言語に基づいたマスク言語を指定します。また、そのプラットフォームから移行するユーザーには非常になじみがある必要があります。The standard provider specifies a masking language based upon the one used by the Masked Edit control in Visual Basic 6.0, and should be very familiar to users migrating from that platform.

マスク要素Masking element 説明Description
00 数字、必須。Digit, required. この要素は、0から9までの任意の1桁を受け入れます。This element will accept any single digit between 0 and 9.
99 数字またはスペース、省略可能。Digit or space, optional.
# 数字またはスペース、省略可能。Digit or space, optional. マスクでこの位置が空白の場合は、 Textプロパティにスペースとして表示されます。If this position is blank in the mask, it will be rendered as a space in the Text property. 正符号 (+) とマイナス記号 (-) は使用できます。Plus (+) and minus (-) signs are allowed.
LL 文字、必須。Letter, required. 入力を ASCII 文字 a ~ z と A ~ Z に制限します。Restricts input to the ASCII letters a-z and A-Z. この mask 要素は、正規表現では [zA-Z] に相当します。This mask element is equivalent to [a-zA-Z] in regular expressions.
?? Letter、省略可能。Letter, optional. 入力を ASCII 文字 a ~ z と A ~ Z に制限します。Restricts input to the ASCII letters a-z and A-Z. この mask 要素は [zA-Z] と同じですか?This mask element is equivalent to [a-zA-Z]? 正規表現で。in regular expressions.
& 文字、必須。Character, required. プロパティがAsciiOnly true に設定されている場合、この要素は "L" 要素のように動作します。If the AsciiOnly property is set to true, this element behaves like the "L" element.
CC Character、optional。Character, optional. 制御文字以外の任意の文字。Any non-control character. プロパティがAsciiOnlyに設定されtrueている場合、この要素は "?" 要素のように動作します。If the AsciiOnly property is set to true, this element behaves like the "?" element.
AA 英数字、必須。Alphanumeric, required. プロパティがにtrue設定されている場合、使用できる文字は、a ~ z と a ~ z の ASCII 文字だけです。 AsciiOnlyIf the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. この mask 要素は、"a" 要素のように動作します。This mask element behaves like the "a" element.
aa 英数字、省略可能。Alphanumeric, optional. プロパティがにtrue設定されている場合、使用できる文字は、a ~ z と a ~ z の ASCII 文字だけです。 AsciiOnlyIf the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. この mask 要素は、"A" 要素のように動作します。This mask element behaves like the "A" element.
.. 小数点のプレースホルダー。Decimal placeholder. 実際に使用される表示文字は、書式プロバイダーに適した小数点の記号になりますFormatProvider 。これは、コントロールのプロパティによって決まります。The actual display character used will be the decimal symbol appropriate to the format provider, as determined by the control's FormatProvider property.
,, 桁区切り記号。Thousands placeholder. 使用される実際の表示文字は、コントロールのFormatProviderプロパティによって決定される書式プロバイダーに適した千単位のプレースホルダーになります。The actual display character used will be the thousands placeholder appropriate to the format provider, as determined by the control's FormatProvider property.
:: 時刻の区切り記号。Time separator. 実際の表示文字は、コントロールのFormatProviderプロパティによって決定される書式プロバイダーに適した時間記号になります。The actual display character used will be the time symbol appropriate to the format provider, as determined by the control's FormatProvider property.
/ 日付の区切り記号。Date separator. 実際の表示文字は、コントロールのFormatProviderプロパティによって決定される書式プロバイダーに適した日付記号になります。The actual display character used will be the date symbol appropriate to the format provider, as determined by the control's FormatProvider property.
$ 通貨記号。Currency symbol. 実際に表示される文字は、書式プロバイダーに適した通貨記号で、コントロールのFormatProviderプロパティによって決定されます。The actual character displayed will be the currency symbol appropriate to the format provider, as determined by the control's FormatProvider property.
< Shift キーを押します。Shift down. 後続のすべての文字を小文字に変換します。Converts all characters that follow to lowercase.
> Shift キーを押します。Shift up. に続くすべての文字を大文字に変換します。Converts all characters that follow to uppercase.
|| 前の shift キーまたは shift キーを押した状態を無効にします。Disable a previous shift up or shift down.
\\ 付ける.Escape. マスク文字をエスケープし、その文字をリテラルに変換します。Escapes a mask character, turning it into a literal. \"\" は円記号のエスケープシーケンスです。"\\" is the escape sequence for a backslash.
上記以外のすべての文字All other characters リテラル.Literals. マスクされていないすべての要素はMaskedTextBox、その中に自身として表示されます。All non-mask elements will appear as themselves within MaskedTextBox. リテラルは、常に実行時にマスク内の静的な位置を占め、ユーザーが移動または削除することはできません。Literals always occupy a static position in the mask at run time, and cannot be moved or deleted by the user.

前のマスクによってMaskedTextBoxフィルター処理されたユーザー入力が既にMaskedTextBox含まれているときにマスクを変更すると、はその入力を新しいマスク定義に移行しようとします。If you change a mask when MaskedTextBox already contains user input filtered by a previous mask, MaskedTextBox will attempt to migrate that input into the new mask definition. 失敗した場合は、既存の入力がクリアされます。If it fails, it will clear the existing input. 長さ0の文字列をマスクとして割り当てると、コントロール内の既存のデータが保持されます。Assigning a zero-length string as the mask will preserve any existing data in the control. 長さがゼロのマスクで使用するとMaskedTextBox 、は単一行TextBoxのコントロールのように動作します。When used with a zero-length mask, MaskedTextBox behaves like a single-line TextBox control.

10進数 (.)、桁区切り記号 (,)、時刻 (:)、日付 (/)、および通貨 ($) のシンボルは、既定では、アプリケーションのカルチャによって定義されている記号を表示します。The decimal (.), thousandths (,), time (:), date (/), and currency ($) symbols default to displaying those symbols as defined by the application's culture. FormatProviderプロパティを使用して、別のカルチャのシンボルを表示するように強制できます。You can force them to display symbols for another culture by using the FormatProvider property.

実行時のマスクへの文字の挿入は、 InsertKeyModeプロパティによって制御されます。Character insertion into the mask at run time is controlled by the InsertKeyMode property. ユーザーは、左矢印キーまたは右方向キーまたはマウスカーソルを使用してマスク内を移動できます。また、スペースを入力すると、マスク内のオプションの位置をスキップできます。Users can navigate through the mask by using the left and right arrow keys or the mouse cursor, and can skip optional positions in the mask by entering a space.

重要

MaskedTextBoxサロゲートと垂直結合文字を除くすべての Unicode 文字をサポートします。MaskedTextBox supports all Unicode characters except for surrogates and vertically combined characters.

マスクの例を次の表に示します。The following table shows example masks.

マスクMask 動作Behavior
00/00/0000 国際日付形式の日付 (日、数値、月、年)。A date (day, numeric month, year) in international date format. "/" 文字は論理日付の区切り記号であり、アプリケーションの現在のカルチャに適した日付の区切り記号としてユーザーに表示されます。The "/" character is a logical date separator, and will appear to the user as the date separator appropriate to the application's current culture.
00->L<LL-0000 米国形式の日付 (日、月の省略形、および年)。3文字の月の省略形は、最初の大文字と2つの小文字で表示されます。A date (day, month abbreviation, and year) in United States format in which the three-letter month abbreviation is displayed with an initial uppercase letter followed by two lowercase letters.
(999)-000-0000 米国電話番号、市外局番は省略可能です。United States phone number, area code optional. ユーザーがオプションの文字を入力したくない場合は、スペースを入力するか、最初の0によって表されるマスク内の位置にマウスポインターを直接配置できます。If users do not want to enter the optional characters, they can either enter spaces or place the mouse pointer directly at the position in the mask represented by the first 0.
$999,999.00 0 ~ 999999 の範囲の通貨値。A currency value in the range of 0 to 999999. 通貨、分、および10進文字は、実行時にカルチャ固有の同等のものに置き換えられます。The currency, thousandth, and decimal characters will be replaced at run time with their culture-specific equivalents.

適用対象

こちらもご覧ください