PasswordBox.PasswordRevealMode Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

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à

PasswordRevealMode

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.

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.

Vedi anche

• PasswordRevealMode