PasswordBox.PasswordRevealMode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kennwort immer, nie oder optional verdeckt ist.
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 PasswordRevealModeEigenschaftswert
Ein Wert der Aufzählung, die angibt, ob das Kennwort immer, nie oder optional verdeckt ist. Der Standardwert ist "Vorschau".
Beispiele
In diesem Beispiel wird gezeigt, wie Sie mithilfe eines CheckBox-Steuerelements den Anzeigemodus eines PasswordBox-Steuerelements wechseln können.
<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 Zeichen zu ändern, das zum Verdecken des Kennworts verwendet wird, legen Sie die PasswordChar-Eigenschaft fest.
Hinweis
PasswordRevealMode ersetzt IsPasswordRevealButtonEnabled , um Ihnen weitere Optionen für die Anzeige ihres Kennworts durch den Benutzer zu bieten. Die IsPasswordRevealButtonEnabled-Eigenschaft wird ignoriert.
Vorschaumodus
Standardmäßig wird die Schaltfläche zum Anzeigen des Kennworts (oder die Schaltfläche "Vorschau") angezeigt. Der Benutzer muss kontinuierlich auf die Schaltfläche drücken, um das Kennwort anzuzeigen, damit ein hohes Sicherheitsniveau beibehalten wird.
Der Wert dieser Eigenschaft ist nicht der einzige Faktor, der bestimmt, ob eine Schaltfläche zum Anzeigen eines Kennworts 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-Steuerelement den Fokus zum ersten Mal erhält und ein Zeichen eingegeben wird. Wenn das PasswordBox-Steuerelement den Fokus verliert und dann wieder den Fokus erhält, wird die Schaltfläche zum Anzeigen erst wieder angezeigt, wenn das Kennwort gelöscht wird und der Zeicheneintrag beginnt.
Ausgeblendeter und sichtbarer Modus
Die anderen PasswordRevealMode-Enumerationswerte und Visible, blenden die Schaltfläche zum Anzeigen des Kennworts aus, und lassen Sie programmgesteuert verwalten, Hidden ob das Kennwort verdeckt ist.
Um das Kennwort immer zu verdecken, legen Sie es PasswordRevealMode auf Hidden. Wenn Sie das Kennwort nicht immer verdeckt benötigen, können Sie eine benutzerdefinierte Benutzeroberfläche bereitstellen, damit der Benutzer zwischen PasswordRevealModeHidden und .Visible Im Abschnitt "Beispiele" erfahren Sie, wie Sie mithilfe eines CheckBox-Steuerelements umschalten können, ob das Kennwort verdeckt ist. Sie können auch andere Steuerelemente verwenden, wie z. B. ToggleButton, damit der Benutzer Modi wechseln kann.
