PasswordBox.PasswordRevealMode Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft einen Wert ab, der angibt, ob das Kennwort immer, nie oder optional verdeckt ist, oder legt diesen fest.

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

PasswordRevealMode PasswordRevealMode();

void PasswordRevealMode(PasswordRevealMode value);

public PasswordRevealMode PasswordRevealMode { get; set; }

var passwordRevealMode = passwordBox.passwordRevealMode;
passwordBox.passwordRevealMode = passwordRevealMode;

Public Property PasswordRevealMode As PasswordRevealMode

Eigenschaftswert

PasswordRevealMode

Ein Wert der -Enumeration, der angibt, ob das Kennwort immer, nie oder optional verdeckt ist. Der Standardwert ist Peek.

Beispiele

In diesem Beispiel wird gezeigt, wie Ein CheckBox verwendet wird , damit ein Benutzer den Anzeigemodus eines PasswordBox-Steuerelements wechseln kann.

<StackPanel Width="200">
    <PasswordBox Name="passwordBox1" 
                 PasswordRevealMode="Hidden"/>
    <CheckBox Name="revealModeCheckBox" Content="Show password"
              IsChecked="False" 
              Checked="CheckBox_Changed" Unchecked="CheckBox_Changed"/>
</StackPanel>

private void CheckBox_Changed(object sender, RoutedEventArgs e)
{
    if (revealModeCheckBox.IsChecked == true)
    {
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Visible;
    }
    else
    {
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Hidden;
    }
}

Hinweise

Um das Zum Verschleiern des Kennworts verwendete Zeichen zu ändern, legen Sie die PasswordChar-Eigenschaft fest.

Hinweis

PasswordRevealMode ersetzt IsPasswordRevealButtonEnabled , um Ihnen mehr Optionen zu bieten, wie der Benutzer sein Kennwort anzeigen kann. Die IsPasswordRevealButtonEnabled-Eigenschaft wird ignoriert.

Vorschaumodus

Standardmäßig wird die Schaltfläche zum Anzeigen des Kennworts (oder die Vorschau-Schaltfläche) angezeigt. Der Benutzer muss die Schaltfläche gedrückt halten, um das Kennwort anzuzeigen, sodass ein hohes Maß an Sicherheit gewährleistet ist.

Der Wert dieser Eigenschaft ist nicht der einzige Faktor, der bestimmt, ob eine Schaltfläche zum Anzeigen von Kennwörtern für den Benutzer sichtbar ist. Weitere Faktoren sind, ob das Steuerelement über einer Mindestbreite angezeigt wird, ob das PasswordBox-Steuerelement den Fokus hat und ob das Texteingabefeld mindestens ein Zeichen enthält. Aus Sicherheitsgründen wird die Schaltfläche zum Anzeigen des Kennworts nur angezeigt, wenn das PasswordBox-Objekt zum ersten Mal den Fokus erhält und ein Zeichen eingegeben wird. Wenn das PasswordBox den Fokus verliert und dann wieder den Fokus erhält, wird die Schaltfläche zum Anzeigen nicht erneut angezeigt, es sei denn, das Kennwort wird gelöscht und die Zeicheneingabe beginnt von vorne.

Ausblendungs- und Anzeigemodus

Die anderen PasswordRevealMode-EnumerationswerteHidden und Visibleblenden die Schaltfläche zum Anzeigen des Kennworts aus und ermöglichen Es Ihnen, programmgesteuert zu verwalten, ob das Kennwort verdeckt ist.

Um das Kennwort immer zu verschleiern, legen Sie auf fest PasswordRevealModeHidden. Sofern das Kennwort nicht immer verdeckt werden muss, können Sie eine benutzerdefinierte Benutzeroberfläche bereitstellen, mit der der Benutzer zwischen Hidden und Visibleumschalten PasswordRevealMode kann. Im Abschnitt Beispiele erfahren Sie, wie Sie mithilfe eines CheckBox-Steuerelements umschalten, ob das Kennwort verdeckt ist oder nicht. Sie können auch andere Steuerelemente wie ToggleButton verwenden, damit der Benutzer zwischen den Modi wechseln kann.

Weitere Informationen

• PasswordRevealMode