MaskedTextProvider クラス
アセンブリ: System (system.dll 内)


MaskedTextBox コントロールには、リテラル文字と書式設定要素で構成されるマスクが含まれており、マスクに対してすべてのユーザー入力がテストされます。Windows フォームでは、特定のマスク解析エンジンを MaskedTextBox に永続的に関連付けるのではなく、MaskedTextProvider クラスによって表される個別のサービスとして提供します。このクラスは、Mask プロパティに関するドキュメントで説明するマスク言語の構文を定義します。
MaskedTextBox クラスのメンバの多くは、関連付けられた MaskedTextProvider の同様の名前が付けられたメンバへの実装を参照します。たとえば、MaskedTextBox クラスの MaskedTextBox.PromptChar プロパティは、MaskedTextProvider クラスの PromptChar へのすべてのアクセスを参照します。
MaskedTextProvider で使用されるマスク解析エンジンは、Microsoft Visual Basic Version 6 に含まれるマスク エディット コントロールの後にモデル化されたものです。そのマスク言語については、Mask プロパティに関するドキュメントに記載されています。
MaskedTextProvider クラスに関連する 3 種類の文字列を次に示します。
文字列名 | |
---|---|
マスクが適用される入力として使用する文字を表します。実際には、入力文字列は Add、Replace、InsertAt、Remove などの複数の入力操作で構成できます。したがって、入力文字列に直接アクセスすることはできません。ただし、入力文字の処理のさまざまな部分は、AllowPromptAsInput と AsciiOnly、ResetOnPrompt、および ResetOnSpace の各プロパティを使用して設定できます。 | |
入力文字列を書式設定された文字列に変換する際に使用する入力書式設定マスクを表します。この文字列は、MaskedTextProvider で設定し、主に Mask プロパティからアクセスします。マスクの特性は、Length、PasswordChar、PromptChar の各プロパティなど、他のメンバを通じて使用することもできます。 | |
フル マスクを入力文字列に適用したときの結果を示す文字列を表します。書式設定された文字列には、Item、Length、LastAssignedPosition、MaskFull、MaskCompleted、FindEditPositionFrom など、クラスの多数のメンバで問い合わせることができます。書式設定された文字列の完全な値は、ToDisplayString メソッドおよび ToString メソッドから使用できます。 |

System.ComponentModel.MaskedTextProvider


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider メンバ
System.ComponentModel 名前空間
MaskedTextBox
MaskedTextBox.MaskedTextProvider
Mask
MaskedTextProvider コンストラクタ (String)
アセンブリ: System (system.dll 内)


このコンストラクタを使用することは、System.ComponentModel.MaskedTextProvider(String,CultureInfo,Boolean,Char,Char,Boolean) コンストラクタを次のように呼び出すこととまったく同じです。

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider コンストラクタ (String, Boolean)
アセンブリ: System (system.dll 内)

Dim mask As String Dim restrictToAscii As Boolean Dim instance As New MaskedTextProvider(mask, restrictToAscii)

このコンストラクタを使用することは、System.ComponentModel.MaskedTextProvider(String,CultureInfo,Boolean,Char,Char,Boolean) コンストラクタを次のように呼び出すこととまったく同じです。
MaskedTextProvider(mask , null, true, '_', '\0', restrictToASCII)

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider コンストラクタ (String, CultureInfo, Boolean)
アセンブリ: System (system.dll 内)

Dim mask As String Dim culture As CultureInfo Dim restrictToAscii As Boolean Dim instance As New MaskedTextProvider(mask, culture, restrictToAscii)
public function MaskedTextProvider ( mask : String, culture : CultureInfo, restrictToAscii : boolean )

このコンストラクタを使用することは、System.ComponentModel.MaskedTextProvider(String,CultureInfo,Boolean,Char,Char,Boolean) コンストラクタを次のように呼び出すこととまったく同じです。
MaskedTextProvider(mask , culture, true, '_', '\0', restrictToAscii)

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider コンストラクタ (String, Char, Boolean)
アセンブリ: System (system.dll 内)

Dim mask As String Dim passwordChar As Char Dim allowPromptAsInput As Boolean Dim instance As New MaskedTextProvider(mask, passwordChar, allowPromptAsInput)
public function MaskedTextProvider ( mask : String, passwordChar : char, allowPromptAsInput : boolean )

このコンストラクタを使用することは、System.ComponentModel.MaskedTextProvider(String,CultureInfo,Boolean,Char,Char,Boolean) コンストラクタを次のように呼び出すこととまったく同じです。
MaskedTextProvider(mask , null, allowPromptAsInput, '_', passwordChar, false)

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider コンストラクタ

名前 | 説明 |
---|---|
MaskedTextProvider (String) | 指定したマスクを使用して、MaskedTextProvider クラスの新しいインスタンスを初期化します。 |
MaskedTextProvider (String, Boolean) | 指定したマスクと ASCII 制限値を使用して、MaskedTextProvider クラスの新しいインスタンスを初期化します。 |
MaskedTextProvider (String, CultureInfo) | 指定したマスクとカルチャを使用して、MaskedTextProvider クラスの新しいインスタンスを初期化します。 |
MaskedTextProvider (String, Char, Boolean) | 指定したマスク、パスワード文字、プロンプト使用値を使用して、MaskedTextProvider クラスの新しいインスタンスを初期化します。 |
MaskedTextProvider (String, CultureInfo, Boolean) | 指定したマスク、カルチャ、および ASCII 制限値を使用して、MaskedTextProvider クラスの新しいインスタンスを初期化します。 |
MaskedTextProvider (String, CultureInfo, Char, Boolean) | 指定したマスク、カルチャ、パスワード文字、およびプロンプト使用値を使用して、MaskedTextProvider クラスの新しいインスタンスを初期化します。 |
MaskedTextProvider (String, CultureInfo, Boolean, Char, Char, Boolean) | 指定したマスク、カルチャ、プロンプト使用値、プロンプト文字、パスワード文字、および ASCII 制限値を使用して、MaskedTextProvider クラスの新しいインスタンスを初期化します。 |

MaskedTextProvider コンストラクタ (String, CultureInfo, Boolean, Char, Char, Boolean)
アセンブリ: System (system.dll 内)

Public Sub New ( _ mask As String, _ culture As CultureInfo, _ allowPromptAsInput As Boolean, _ promptChar As Char, _ passwordChar As Char, _ restrictToAscii As Boolean _ )
Dim mask As String Dim culture As CultureInfo Dim allowPromptAsInput As Boolean Dim promptChar As Char Dim passwordChar As Char Dim restrictToAscii As Boolean Dim instance As New MaskedTextProvider(mask, culture, allowPromptAsInput, promptChar, passwordChar, restrictToAscii)
public MaskedTextProvider ( string mask, CultureInfo culture, bool allowPromptAsInput, char promptChar, char passwordChar, bool restrictToAscii )
public: MaskedTextProvider ( String^ mask, CultureInfo^ culture, bool allowPromptAsInput, wchar_t promptChar, wchar_t passwordChar, bool restrictToAscii )
public MaskedTextProvider ( String mask, CultureInfo culture, boolean allowPromptAsInput, char promptChar, char passwordChar, boolean restrictToAscii )
public function MaskedTextProvider ( mask : String, culture : CultureInfo, allowPromptAsInput : boolean, promptChar : char, passwordChar : char, restrictToAscii : boolean )


このコンストラクタは、最も一般的なオーバーロード形式を表します。mask パラメータは、MaskedTextProvider クラスによって定義されたマスク言語に準拠している必要があります。詳細については、MaskedTextBox クラスの MaskedTextBox.Mask プロパティに関するトピックで説明しています。
カルチャ固有の情報について、ニュートラル カルチャに問い合わせることはできないため、MaskedTextProvider コンストラクタは、GetCultures メソッドを使用して、適切な区切り記号を判断する際に使用する最初の非ニュートラル カルチャを検索します。

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider コンストラクタ (String, CultureInfo, Char, Boolean)
アセンブリ: System (system.dll 内)

Public Sub New ( _ mask As String, _ culture As CultureInfo, _ passwordChar As Char, _ allowPromptAsInput As Boolean _ )
Dim mask As String Dim culture As CultureInfo Dim passwordChar As Char Dim allowPromptAsInput As Boolean Dim instance As New MaskedTextProvider(mask, culture, passwordChar, allowPromptAsInput)
public MaskedTextProvider ( string mask, CultureInfo culture, char passwordChar, bool allowPromptAsInput )
public: MaskedTextProvider ( String^ mask, CultureInfo^ culture, wchar_t passwordChar, bool allowPromptAsInput )
public MaskedTextProvider ( String mask, CultureInfo culture, char passwordChar, boolean allowPromptAsInput )
public function MaskedTextProvider ( mask : String, culture : CultureInfo, passwordChar : char, allowPromptAsInput : boolean )

このコンストラクタを使用することは、System.ComponentModel.MaskedTextProvider(String,CultureInfo,Boolean,Char,Char,Boolean) コンストラクタを次のように呼び出すこととまったく同じです。
MaskedTextProvider(mask , culture, allowPromptAsInput, '_', passwordChar, false)

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider コンストラクタ (String, CultureInfo)
アセンブリ: System (system.dll 内)


このコンストラクタを使用することは、System.ComponentModel.MaskedTextProvider(String,CultureInfo,Boolean,Char,Char,Boolean) コンストラクタを次のように呼び出すこととまったく同じです。

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MaskedTextProvider プロパティ

名前 | 説明 | |
---|---|---|
![]() | IsPassword | 書式設定された文字列に、パスワードによる保護を適用する必要があるかどうかを決定する値を取得または設定します。 |
![]() | Item | 書式設定された文字列内の指定した位置にある要素を取得します。 |
![]() | LastAssignedPosition | マスクに割り当てられている右端の入力文字のマスク内のインデックスを取得します。 |
![]() | Length | マスク修飾子文字を除いたマスクの長さを取得します。 |
![]() | Mask | 入力マスクを取得します。 |
![]() | MaskCompleted | すべての必須入力が、書式設定された文字列に入力されているかどうかを示す値を取得します。 |
![]() | MaskFull | すべての必須入力と省略可能な入力が、書式設定された文字列に入力されているかどうかを示す値を取得します。 |
![]() | PasswordChar | 実際の入力文字を置き換える文字を取得または設定します。 |
![]() | PromptChar | 使用できるすべての編集位置に対してユーザー入力がないことを表す際に使用する文字を取得または設定します。 |
![]() | ResetOnPrompt | プロンプト文字と一致する入力文字を処理する方法を決定する値を取得または設定します。 |
![]() | ResetOnSpace | 空白入力文字を処理する方法を決定する値を取得または設定します。 |
![]() | SkipLiterals | マスク内のリテラル文字の位置を、同じ値で上書きできるかどうかを示す値を取得または設定します。 |

関連項目
MaskedTextProvider クラスSystem.ComponentModel 名前空間
MaskedTextBox
MaskedTextBox.MaskedTextProvider
Mask
MaskedTextProvider メソッド


名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

関連項目
MaskedTextProvider クラスSystem.ComponentModel 名前空間
MaskedTextBox
MaskedTextBox.MaskedTextProvider
Mask
MaskedTextProvider メンバ
MaskedTextBox コントロールなど、マスクをサポートする多数のコントロールで使用できるマスク解析サービスを表します。
MaskedTextProvider データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | IsPassword | 書式設定された文字列に、パスワードによる保護を適用する必要があるかどうかを決定する値を取得または設定します。 |
![]() | Item | 書式設定された文字列内の指定した位置にある要素を取得します。 |
![]() | LastAssignedPosition | マスクに割り当てられている右端の入力文字のマスク内のインデックスを取得します。 |
![]() | Length | マスク修飾子文字を除いたマスクの長さを取得します。 |
![]() | Mask | 入力マスクを取得します。 |
![]() | MaskCompleted | すべての必須入力が、書式設定された文字列に入力されているかどうかを示す値を取得します。 |
![]() | MaskFull | すべての必須入力と省略可能な入力が、書式設定された文字列に入力されているかどうかを示す値を取得します。 |
![]() | PasswordChar | 実際の入力文字を置き換える文字を取得または設定します。 |
![]() | PromptChar | 使用できるすべての編集位置に対してユーザー入力がないことを表す際に使用する文字を取得または設定します。 |
![]() | ResetOnPrompt | プロンプト文字と一致する入力文字を処理する方法を決定する値を取得または設定します。 |
![]() | ResetOnSpace | 空白入力文字を処理する方法を決定する値を取得または設定します。 |
![]() | SkipLiterals | マスク内のリテラル文字の位置を、同じ値で上書きできるかどうかを示す値を取得または設定します。 |


名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

関連項目
MaskedTextProvider クラスSystem.ComponentModel 名前空間
MaskedTextBox
MaskedTextBox.MaskedTextProvider
Mask
- MaskedTextProviderのページへのリンク