MaskedTextBox.Mask 屬性

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

取得或設定執行階段所要使用的輸入遮罩。

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

屬性值

String

String，表示目前的遮罩。 預設值為允許任何輸入的空字串。

例外狀況

ArgumentException

提供給 Mask 屬性的字串不是有效的遮罩。 無效的遮罩包括含有不可列印字元的遮罩。

備註

Mask 是類別的預設屬性 MaskedTextBox 。

Mask 必須是由一或多個遮罩元素組成的字串，如下表所示。 所使用的 MaskedTextBox 遮罩語言是由其相關聯的 MaskedTextProvider所定義。 標準提供者會根據 Visual Basic 6.0 中遮罩編輯控件所使用的遮罩語言來指定遮罩語言，而且應該非常熟悉從該平臺移轉的使用者。

遮罩元素 描述
0 數位，必要。 這個專案將接受介於 0 到 9 之間的任何單一數位。
9 數位或空格，選擇性。
# 數位或空格，選擇性。 如果遮罩中這個位置是空白的，則會轉譯為 屬性中的 Text 空格。 允許加號 (+) 和減號 (-)。
L 信件，必要。 限制 ASCII 字母 a-z 和 A-Z 的輸入。 這個 mask 元素相當於正則表示式中的 [a-zA-Z]。
? 字母，選擇性。 限制 ASCII 字母 a-z 和 A-Z 的輸入。 此 mask 元素相當於 [a-zA-Z]？ 正規表示式中的 。
& 字元，必要。 如果屬性 AsciiOnly 設定為 true，這個元素的行為就像 「L」 元素。
C 字元，選擇性。 任何非控制字元。 AsciiOnly如果 屬性設定為 true，這個元素的行為就像是 “？” 元素。
A 英數位元，必要。 AsciiOnly如果 屬性設定為 true，它將接受的唯一字元是 ASCII 字母 a-z 和 A-Z。 此mask元素的行為與「a」 項目類似。
a 英數位元，選擇性。 AsciiOnly如果 屬性設定為 true，它將接受的唯一字元是 ASCII 字母 a-z 和 A-Z。 此 mask 元素的行為就像 「A」 元素。
. 小數預留位置。 使用的實際顯示字元會是適合格式提供者的十進位符號，如控件的 FormatProvider 屬性所決定。
, 千位佔位元。 使用的實際顯示字元會是適合格式提供者的千位佔位元，如控件的 FormatProvider 屬性所決定。
: 時間分隔符號。 使用的實際顯示字元會是適合格式提供者的時間符號，如控件的 FormatProvider 屬性所決定。
/ 日期分隔符號。 使用的實際顯示字元會是適合格式提供者的日期符號，如控件的 FormatProvider 屬性所決定。
$ 貨幣符號。 顯示的實際字元會是適合格式提供者的貨幣符號，如控件的 FormatProvider 屬性所決定。
< 向下移位。 將後面的所有字元轉換成小寫。
> 向上移位。 將後面的所有字元轉換成大寫。
| 停用上一個移位或向下移位。
\ 逃脫。 逸出遮罩字元，將其轉換為常值。 "\\" 是反斜線的逸出序列。
所有其他字元 常值。 所有非遮罩元素都會以自身顯示在 MaskedTextBox 中。 常值一律會在運行時間佔用遮罩中的靜態位置，而且使用者無法移動或刪除。

如果您變更遮罩時 MaskedTextBox 已經包含先前遮罩篩選的使用者輸入， MaskedTextBox 將會嘗試將該輸入移轉至新的遮罩定義。 如果失敗，則會清除現有的輸入。 指派長度為零的字串，因為遮罩會保留 控件中的任何現有數據。 與長度為零的遮罩搭配使用時， MaskedTextBox 其行為就像單行控件一樣 TextBox 。

小數點 (.)、千位 (,)、時間 (:)、日期 (/) 和貨幣 ($) 符號，預設為如應用程式文化特性所定義顯示這些符號。 您可以使用 FormatProvider 屬性，強制顯示另一個文化特性的符號。

在運行時間插入遮罩中的字元是由 屬性所控制 InsertKeyMode 。 使用者可以使用向左鍵和向右鍵或滑鼠游標流覽遮罩，並輸入空格來略過遮罩中的選擇性位置。

重要

MaskedTextBox 支援除了 Surrogate 和垂直合併字元以外的所有 Unicode 字元。

下表顯示範例遮罩。

Mask 行為
00/00/0000 日期 (日、數值月份、年) 國際日期格式。 “/” 字元是邏輯日期分隔符，用戶會顯示為應用程式目前文化特性適用的日期分隔符。
00->L<LL-0000 以美國格式顯示的日期 (日、月縮寫和年)，其三個字母月份縮寫開頭為大寫字母後面接著兩個小寫字母。
(999)-000-0000 美國電話號碼，區碼為選擇性。 如果使用者不想要輸入選擇性字元，他們可以輸入空格，或將滑鼠指標直接放在前 0 個所代表遮罩中的位置。
$999,999.00 介於 0 到 999999 範圍內的貨幣值。 貨幣、千位和小數點字元，會在執行階段以其文化特性專屬的同等項目取代。

適用於

另請參閱