PasswordBox.PasswordChar Property

Reference

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the masking character for the PasswordBox.

public:
 property char PasswordChar { char get(); void set(char value); };

public char PasswordChar { get; set; }

member this.PasswordChar : char with get, set

Public Property PasswordChar As Char

Property Value

Char

A masking character to echo when the user enters text into the PasswordBox. The default value is a bullet character (●).

Examples

The following example shows how to set the PasswordChar attribute of a PasswordBox element.

<PasswordBox
  Name="pwdBox" 
  MaxLength="64"
  PasswordChar="#"
  PasswordChanged="PasswordChangedHandler"  
/>

The following example shows how to set the PasswordChar property programmatically.

// Change the password masking character to a period.
pwdBox.PasswordChar = '.';

' Change the password masking character to a period.
pwdBox.PasswordChar = "."c

Remarks

When text is entered into a PasswordBox, the masking character specified by this property is echoed in the password input field, rather than the actual password itself. This helps prevent passwords from being exposed to casual observers when they are entered.

Dependency Property Information

Item	Value
Identifier field	PasswordCharProperty
Metadata properties set to `true`	None

Applies to

Jaa