PasswordBox.PasswordRevealMode Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit une valeur qui spécifie si le mot de passe est toujours, jamais ou éventuellement masqué.

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

Valeur de propriété

PasswordRevealMode

Valeur de l’énumération qui spécifie si le mot de passe est toujours, jamais ou éventuellement masqué. La valeur par défaut est Aperçu.

Exemples

Cet exemple montre comment utiliser un contrôle CheckBox pour permettre à un utilisateur de changer le mode d’affichage d’un PasswordBox.

<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;
    }
}

Remarques

Pour modifier le caractère utilisé pour masquer le mot de passe, définissez la propriété PasswordChar .

Notes

PasswordRevealMode remplace IsPasswordRevealButtonEnabled pour vous donner plus d’options sur la façon dont l’utilisateur peut afficher son mot de passe. La propriété IsPasswordRevealButtonEnabled est ignorée.

Mode aperçu

Par défaut, le bouton d’affichage du mot de passe (ou « bouton d’aperçu ») s’affiche. L’utilisateur doit rester appuyé sur le bouton pour afficher le mot de passe, afin de maintenir un niveau élevé de sécurité.

La valeur de cette propriété n’est pas le seul facteur qui détermine si un bouton d’affichage de mot de passe est visible par l’utilisateur. D’autres facteurs incluent si le contrôle est affiché au-dessus d’une largeur minimale, si le PasswordBox a le focus et si le champ de saisie de texte contient au moins un caractère. Pour des raisons de sécurité, le bouton d’affichage du mot de passe s’affiche uniquement lorsque passwordBox reçoit le focus pour la première fois et qu’un caractère est entré. Si passwordBox perd le focus, puis reprend le focus, le bouton révéler ne s’affiche plus, sauf si le mot de passe est effacé et que l’entrée de caractères recommence.

Modes Masqué et Visible

Les autres valeurs d’énumération PasswordRevealMode , Hidden et Visible, masquent le bouton d’affichage du mot de passe et vous permettent de gérer par programmation si le mot de passe est masqué.

Pour toujours masquer le mot de passe, définissez sur PasswordRevealModeHidden. Sauf si vous avez besoin que le mot de passe soit toujours masqué, vous pouvez fournir une interface utilisateur personnalisée pour permettre à l’utilisateur de basculer PasswordRevealMode entre Hidden et Visible. Consultez la section Exemples pour savoir comment utiliser un contrôle CheckBox pour indiquer si le mot de passe est masqué ou non. Vous pouvez également utiliser d’autres contrôles, tels que ToggleButton, pour permettre à l’utilisateur de basculer entre les modes.

Voir aussi

• PasswordRevealMode