Edit

Share via


PasswordBox.PasswordChar Property

Definition

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

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