MaskedTextProvider 類別

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

來源:

MaskedTextProvider.cs

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

public ref class MaskedTextProvider : ICloneable

public class MaskedTextProvider : ICloneable

type MaskedTextProvider = class
    interface ICloneable

Public Class MaskedTextProvider
Implements ICloneable

繼承

Object

MaskedTextProvider

實作

ICloneable

備註

控制項 MaskedTextBox 包含一個遮罩，由常值字元和格式化元素所組成，它會測試所有使用者輸入。 除了將特定遮罩剖析引擎 MaskedTextBox 與 建立永久關聯，Windows Forms提供它做為個別服務 MaskedTextProvider ，此類別會定義 屬性檔中 Mask 所討論遮罩語言的語法。

類別的許多 MaskedTextBox 成員都參考其實作，類似于相關聯 MaskedTextProvider 的具名成員。 例如，類別 MaskedTextBox.PromptChar 的 MaskedTextBox 屬性會參考 類別的所有 MaskedTextProvider 存取 PromptChar 權。

所使用的 MaskedTextProvider 遮罩剖析引擎會在 Visual Basic 第 6 版Microsoft包含的遮罩編輯控制項之後建立模型。 其遮罩語言會在 屬性的檔 Mask 中描述。

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

名稱字串	描述
輸入字元或字串	表示用來作為套用遮罩之輸入的字元。 實際上，輸入字串可能是由多個輸入作業所組成，包括 Add 、 ReplaceInsertAt 和 Remove 。 因此，無法直接存取輸入字串。 不過，輸入字串處理的層面可透過 AllowPromptAsInput 和 AsciiOnly 、 ResetOnPrompt 和 ResetOnSpace 屬性來使用。
Mask	表示用來將輸入字串轉換成格式化字串的輸入格式遮罩。 這個字串是在 中 MaskedTextProvider 設定，主要是透過 屬性來 Mask 存取。 遮罩的特性也可透過其他成員取得，例如 Length 、 PasswordChar 和 PromptChar 屬性。
格式化字串	表示當完整遮罩套用至輸入字串時所產生的字串。 您可以使用 類別的許多成員來查詢格式化字串，包括 Item[] 、 Length 、 LastAssignedPosition 、 MaskFull 、 MaskCompleted 、 FindEditPositionFrom 等等。 格式化字串的完整值可從 ToDisplayString 和 ToString 方法取得。

注意

輸入字串可能代表直接使用者輸入，如同 在 案例 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)	測試是否可以成功設定指定的字串，然後輸出位置和描述性資訊。

另請參閱

• MaskedTextBox
• MaskedTextProvider
• Mask