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,
	char promptChar,
	char 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.

ExceptionCondition
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

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft