MaskedTextBox.UseSystemPasswordChar Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gets or sets a value indicating whether the operating system-supplied password character should be used.

public:
 property bool UseSystemPasswordChar { bool get(); void set(bool value); };

public bool UseSystemPasswordChar { get; set; }

member this.UseSystemPasswordChar : bool with get, set

Public Property UseSystemPasswordChar As Boolean

Property Value

Boolean

true if the system password should be used as the prompt character; otherwise, false. The default is false.

Exceptions

InvalidOperationException

The password character specified is the same as the current prompt character, PromptChar. The two are required to be different.

Remarks

The UseSystemPasswordChar property determines whether user-supplied input should be displayed in the MaskedTextBox as multiple occurrences of a password character defined by the operating system. UseSystemPasswordChar functions similarly to the PasswordChar property, but instead of using a programmer-supplied character for the prompt, UseSystemPasswordChar uses a prompt defined by the operating system. This property has precedence over PasswordChar.

Important

As a security consideration, the MaskedTextBox control disables cut and copy operations on password-protected strings.

See also

• PromptChar
• PasswordChar
• AllowPromptAsInput