PasswordBox.PasswordRevealMode Proprietà

Definizione

Ottiene o imposta un valore che specifica se la password è sempre, mai o facoltativamente oscurata.

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

Valore della proprietà

Valore dell'enumerazione che specifica se la password è sempre, mai o facoltativamente oscurata. Il valore predefinito è Peek.

Esempio

In questo esempio viene illustrato come usare un controllo CheckBox per consentire a un utente di cambiare la modalità di visualizzazione di una 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;
    }
}
Private Sub CheckBox_Changed(sender As Object, e As RoutedEventArgs)
    If revealModeCheckBox.IsChecked = True Then
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Visible
    Else
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Hidden
    End If
End Sub

Commenti

PasswordRevealMode sostituisce IsPasswordRevealButtonEnabled per offrire altre opzioni per il modo in cui l'utente è in grado di visualizzare la password. La proprietà IsPasswordRevealButtonEnabled viene ignorata .

Per modificare il carattere usato per nascondere la password, impostare la proprietà PasswordChar .

Modalità Peek

Per impostazione predefinita, il pulsante di rivelazione della password è visualizzato. L'utente deve continuamente premere il pulsante per vedere la password, in modo da mantenere un livello di sicurezza elevato.

Casella password con la password visualizzata.

Il valore di questa proprietà non è l'unico fattore che determina se un pulsante di visualizzazione della password è visibile all'utente. Altri fattori includono se il controllo viene visualizzato sopra una larghezza minima, se PasswordBox ha lo stato attivo e se il campo voce di testo contiene almeno un carattere. Si noti che a causa di motivi di sicurezza il pulsante di visualizzazione della password viene visualizzato solo quando passwordBox riceve lo stato attivo per la prima volta e viene immesso un carattere. Se passwordBox perde lo stato attivo e quindi recupera lo stato attivo, il pulsante di visualizzazione non viene visualizzato di nuovo a meno che la password non sia cancellata e la voce di carattere inizia.

Nota

Prima di Windows 10, il pulsante di visualizzazione della password non è stato visualizzato per impostazione predefinita. Se la sicurezza dell'app richiede che la password sia sempre oscurata, assicurarsi di impostare PasswordRevealMode su Hidden.

Modalità Hidden e Visible

Gli altri valori di enumerazione di PasswordRevealMode, Hidden e Visible, nascondono il pulsante di rivelazione della password e ti permettono di gestire l'oscuramento della password a livello di programmazione.

Per nascondere sempre la password, impostare PasswordRevealMode su Hidden. A meno che la password non sia sempre oscurata, è possibile fornire un'interfaccia utente personalizzata per consentire all'utente di attivare passwordRevealMode tra Hidden e Visible.

Nelle versioni precedenti di Windows Phone PasswordBox ha usato un controllo CheckBox per attivare se la password è stata oscurata. È possibile creare un'interfaccia utente simile per l'app, come illustrato nell'esempio. Puoi anche usare altri controlli, ad esempio ToggleButton, per consentire all'utente di passare da una modalità all'altra.

Casella password con un interruttore di visualizzazione personalizzato.

Si applica a

Vedi anche