共用方式為


MaskedTextProvider 類別

定義

表示遮罩剖析服務,任何支援遮罩的控制項數目都可以使用它,例如 MaskedTextBox 控制項。

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
繼承
MaskedTextProvider
實作

備註

控件 MaskedTextBox 包含一個遮罩,由常值字元和格式化元素所組成,它會測試所有用戶輸入。 Windows Forms 會以 類別表示MaskedTextProvider,而不是永久將特定遮罩剖析引擎與 MaskedTextBox建立關聯,這會定義 屬性檔中Mask所討論遮罩語言的語法。

類別的許多成員都參考其實作 MaskedTextBox ,類似於相關聯 MaskedTextProvider之的具名成員。 例如,類別MaskedTextBox.PromptCharMaskedTextBox 屬性是指類別的所有MaskedTextProvider存取PromptChar權。

所使用的 MaskedTextProvider 遮罩剖析引擎會模型化為 Microsoft Visual Basic 第 6 版中包含的遮罩編輯控制元件。 其遮罩語言描述於 屬性的檔 Mask 中。

下列三個不同的字串與類別相關 MaskedTextProvider

名稱字串 描述
輸入字元或字串 表示用來做為遮罩所套用輸入的字元。 實際上,輸入字串可能是由多個輸入作業所組成,包括 AddReplaceInsertAtRemove。 因此,無法直接存取輸入字串。 不過,輸入字串處理的各個層面可透過 AllowPromptAsInputAsciiOnlyResetOnPromptResetOnSpace 屬性取得。
Mask 表示用來將輸入字串轉換成格式化字串的輸入格式遮罩。 這個字串是在 中 MaskedTextProvider 設定,主要是透過 Mask 屬性來存取。 遮罩的特性也可以透過其他成員取得,例如 LengthPasswordCharPromptChar 屬性。
格式化字串 表示當完整遮罩套用至輸入字串時所產生的字串。 您可以使用 類別的許多成員查詢格式化字串,包括Item[]LengthLastAssignedPosition、、MaskFullMaskCompletedFindEditPositionFrom等等。 格式化字串的完整值可從 ToDisplayStringToString 方法取得。

注意

輸入字串可能會表示直接使用者輸入,如 的情況 MaskedTextBox,或可能由未直接與使用者輸入/輸出作業相關聯的其他進程產生。

建構函式

MaskedTextProvider(String)

使用指定的遮罩,初始化 MaskedTextProvider 類別的新執行個體。

MaskedTextProvider(String, Boolean)

使用指定的遮罩和 ASCII 限制值,初始化 MaskedTextProvider 類別的新執行個體。

MaskedTextProvider(String, Char, Boolean)

使用指定的遮罩、密碼字元和提示使用值,初始化 MaskedTextProvider 類別的新執行個體。

MaskedTextProvider(String, CultureInfo)

使用指定的遮罩和文化特性,初始化 MaskedTextProvider 類別的新執行個體。

MaskedTextProvider(String, CultureInfo, Boolean)

使用指定的遮罩、文化特性和 ASCII 限制值,初始化 MaskedTextProvider 類別的新執行個體。

MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)

使用指定的遮罩、文化特性、提示使用值、提示字元、密碼字元和 ASCII 限制值,初始化 MaskedTextProvider 類別的新執行個體。

MaskedTextProvider(String, CultureInfo, Char, Boolean)

使用指定的遮罩、文化特性、密碼字元和提示使用值,初始化 MaskedTextProvider 類別的新執行個體。

屬性

AllowPromptAsInput

取得值,指出提示字元是否應視為有效輸入字元。

AsciiOnly

取得值,指出遮罩是否接受 ASCII 字元集之外的字元。

AssignedEditPositionCount

取得已成功指派輸入值之可編輯的字元位置數目。

AvailableEditPositionCount

取得輸入遮罩中尚未指派輸入值的可編輯字元位置數目。

Culture

取得文化特性,以便判斷輸入遮罩中可當地語系化分隔符號和替代符號的值。

DefaultPasswordChar

取得用來遮蔽使用者輸入的預設密碼字元。

EditPositionCount

取得格式化字串中可編輯的位置數目。

EditPositions

取得格式化字串中可編輯位置的新建立列舉值。

IncludeLiterals

取得或設定值,指出輸入遮罩中的常值字元是否應該包含在格式化字串中。

IncludePrompt

取得或設定值,指出 PromptChar 是否用來表示,在顯示格式化字串時使用者輸入項目不存在。

InvalidIndex

取得無效索引範圍的上限。

IsPassword

取得或設定值,判斷密碼保護是否應套用至格式化字串。

Item[Int32]

取得格式化字串中位於指定位置的項目。

LastAssignedPosition

取得遮罩中最右側指定輸入字元的索引。

Length

取得遮罩長度,不計任何遮罩修飾詞字元。

Mask

取得輸入遮罩。

MaskCompleted

取得值,指出所有必要的輸入項目是否已輸入格式化字串。

MaskFull

取得值,指出所有必要和選擇性的輸入項目是否已輸入格式化字串。

PasswordChar

取得或設定字元,取代實際輸入字元。

PromptChar

取得或設定字元,用來表示所有可用編輯位置的使用者輸入項目不存在。

ResetOnPrompt

取得或設定值,判斷應如何處理符合提示字元的輸入字元。

ResetOnSpace

取得或設定值,判斷應如何處理空格輸入字元。

SkipLiterals

取得或設定值,指出遮罩中的常值字元位置是否可以用其相同值覆寫。

方法

Add(Char)

將指定的輸入字元加入至格式化字串的結尾。

Add(Char, Int32, MaskedTextResultHint)

將指定的輸入字元加入至格式化字串的結尾,然後輸出位置和描述性資訊。

Add(String)

將指定輸入字串的字元加入至格式化字串的結尾。

Add(String, Int32, MaskedTextResultHint)

將指定輸入字串的字元加入至格式化字串的結尾,然後輸出位置和描述性資訊。

Clear()

從格式化字串清除所有可編輯的輸入字元,並取代成提示字元。

Clear(MaskedTextResultHint)

從格式化字串清除所有可編輯的輸入字元,並取代成提示字元,然後輸出描述性資訊。

Clone()

建立目前的 MaskedTextProvider 複本。

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
FindAssignedEditPositionFrom(Int32, Boolean)

使用指定搜尋方向,傳回指定位置之後的第一個指定可編輯位置。

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

使用指定搜尋方向,傳回指定位置之間的第一個指定可編輯位置。

FindEditPositionFrom(Int32, Boolean)

使用指定搜尋方向,傳回指定位置之後的第一個可編輯位置。

FindEditPositionInRange(Int32, Int32, Boolean)

使用指定搜尋方向,傳回指定位置之間的第一個可編輯位置。

FindNonEditPositionFrom(Int32, Boolean)

使用指定搜尋方向,傳回指定位置之後的第一個非可編輯位置。

FindNonEditPositionInRange(Int32, Int32, Boolean)

使用指定搜尋方向,傳回指定位置之間的第一個非可編輯位置。

FindUnassignedEditPositionFrom(Int32, Boolean)

使用指定搜尋方向,傳回指定位置之後第一個未指定的可編輯位置。

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

使用指定搜尋方向,傳回指定位置之間第一個未指定的可編輯位置。

GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetOperationResultFromHint(MaskedTextResultHint)

判斷指定的 MaskedTextResultHint 代表成功或失敗。

GetType()

取得目前執行個體的 Type

(繼承來源 Object)
InsertAt(Char, Int32)

在格式化字串中的指定位置插入指定字元。

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

在格式化字串中的指定位置插入指定字元,並傳回上一個插入位置和作業狀態。

InsertAt(String, Int32)

在格式化字串中的指定位置插入指定字串。

InsertAt(String, Int32, Int32, MaskedTextResultHint)

在格式化字串中的指定位置插入指定字串,並傳回上一個插入位置和作業狀態。

IsAvailablePosition(Int32)

判斷指定的位置是否可用於指派。

IsEditPosition(Int32)

判斷指定的位置是否可編輯。

IsValidInputChar(Char)

判斷指定的字元是否為有效的輸入字元。

IsValidMaskChar(Char)

判斷指定的字元是否為有效的遮罩字元。

IsValidPasswordChar(Char)

判斷指定的字元是否為有效的密碼字元。

MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
Remove()

從格式化字串移除上一個指定的字元。

Remove(Int32, MaskedTextResultHint)

從格式化字串移除上一個指定的字元,然後輸出移除位置和描述性資訊。

RemoveAt(Int32)

移除格式化字串中指定位置上的指定字元。

RemoveAt(Int32, Int32)

移除格式化字串中指定位置之間的指定字元。

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

移除格式化字串中指定位置之間的指定字元,然後輸出移除位置和描述性資訊。

Replace(Char, Int32)

將指定位置或之外的單一字元取代成指定字元值。

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

將指定起始位置和結束位置之間的單一字元取代成指定字元值,然後輸出移除位置和描述性資訊。

Replace(Char, Int32, Int32, MaskedTextResultHint)

將指定位置或之外的單一字元取代成指定字元值,然後輸出移除位置和描述性資訊。

Replace(String, Int32)

從指定的位置開始,將可編輯的字元範圍取代成指定字串。

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

將指定起始位置和結束位置之間的可編輯字元範圍取代成指定字串,然後輸出移除位置和描述性資訊。

Replace(String, Int32, Int32, MaskedTextResultHint)

從指定的位置開始,將可編輯的字元範圍取代成指定字串,然後輸出移除位置和描述性資訊。

Set(String)

將格式化字串設為指定的輸入字串。

Set(String, Int32, MaskedTextResultHint)

將格式化字串設為指定的輸入字串,然後輸出移除位置和描述性資訊。

ToDisplayString()

用可顯示格式傳回格式化字串。

ToString()

傳回格式化字串,包含所有指定的字元值。

ToString(Boolean)

傳回格式化字串,選擇性包含密碼字元。

ToString(Boolean, Boolean)

傳回格式化字串,選擇性包含提示和常值字元。

ToString(Boolean, Boolean, Boolean, Int32, Int32)

傳回格式化字串的子字串,選擇性包含提示、常值和密碼字元。

ToString(Boolean, Boolean, Int32, Int32)

傳回格式化字串的子字串,選擇性包含提示和常值字元。

ToString(Boolean, Int32, Int32)

傳回格式化字串的子字串,選擇性包含密碼字元。

ToString(Int32, Int32)

傳回格式化字串的子字串。

VerifyChar(Char, Int32, MaskedTextResultHint)

測試在指定位置上是否可以成功設定指定的字元。

VerifyEscapeChar(Char, Int32)

測試在指定位置上是否可以逸出指定的字元。

VerifyString(String)

測試是否可以成功設定指定的字串。

VerifyString(String, Int32, MaskedTextResultHint)

測試是否可以成功設定指定的字串,然後輸出位置和描述性資訊。

適用於

另請參閱