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

 

Initializes a new instance of the MaskedTextProvider class using the specified mask, culture, prompt usage value, prompt character, password character, and ASCII restriction value.

Namespace:   System.ComponentModel
Assembly:  System (in System.dll)

public:
MaskedTextProvider(
	String^ mask,
	CultureInfo^ culture,
	bool allowPromptAsInput,
	wchar_t promptChar,
	wchar_t passwordChar,
	bool restrictToAscii
)

Parameters

mask
Type: System::String^

A String that represents the input mask.

culture
Type: System.Globalization::CultureInfo^

A CultureInfo that is used to set region-sensitive separator characters.

allowPromptAsInput
Type: System::Boolean

A Boolean value that specifies whether the prompt character should be allowed as a valid input character.

promptChar
Type: System::Char

A Char that will be displayed as a placeholder for user input.

passwordChar
Type: System::Char

A Char that will be displayed for characters entered into a password string.

restrictToAscii
Type: System::Boolean

true to restrict input to ASCII-compatible characters; otherwise false to allow the entire Unicode set.

Exception Condition
ArgumentException

The mask parameter is null or Empty.

-or-

The mask contains one or more non-printable characters.

This constructor represents the most general overloaded form. The mask parameter must conform to the masking language defined by the MaskedTextProvider class, which is detailed in the MaskedTextBox::Mask property of the MaskedTextBox class.

Because neutral cultures cannot be queried for culture-specific information, the MaskedTextProvider constructor will use the GetCultures method to search for the first non-neutral culture to use to determine the proper separator characters.

.NET Framework
Available since 2.0
Return to top
Show: