Compartilhar via


PasswordBox.PasswordRevealMode Propriedade

Definição

Obtém ou define um valor que especifica se a senha é sempre, nunca ou opcionalmente obscurecida.

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

Valor da propriedade

Um valor da enumeração que especifica se a senha é sempre, nunca ou opcionalmente obscurecida. O padrão é Espiar.

Exemplos

Este exemplo mostra como usar uma CheckBox para permitir que um usuário alterne o modo de revelação de uma 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

Comentários

PasswordRevealMode substitui IsPasswordRevealButtonEnabled para fornecer mais opções de como o usuário é capaz de exibir sua senha. A propriedade IsPasswordRevealButtonEnabled é ignorada.

Para alterar o caractere usado para obscurecer a senha, defina a propriedade PasswordChar .

Modo espiada

Por padrão, o botão de revelação de senha (ou botão de "espiada") é exibido. O usuário deve pressionar continuamente o botão para exibir a senha, para que um alto nível de segurança seja mantido.

Uma caixa de senha com a senha mostrada.

O valor dessa propriedade não é o único fator que determina se um botão de revelação de senha está visível para o usuário. Outros fatores incluem se o controle é exibido acima de uma largura mínima, se o PasswordBox tem foco e se o campo de entrada de texto contém pelo menos um caractere. Observe que, por motivos de segurança, o botão de revelação de senha é mostrado somente quando a PasswordBox recebe o foco pela primeira vez e um caractere é inserido. Se a PasswordBox perder o foco e, em seguida, recuperar o foco, o botão de revelação não será mostrado novamente, a menos que a senha seja desmarcada e a entrada de caractere comece novamente.

Observação

Antes do Windows 10, o botão de revelação de senha não era mostrado por padrão. Se a segurança do aplicativo exigir que a senha seja sempre obscurecida, defina PasswordRevealMode como Oculto.

Modos ocultos e visíveis

Os outros valores de enumeração PasswordRevealMode, Hidden e Visible, ocultam o botão de revelar senha e permitem que você gerencie programaticamente se a senha é ocultada.

Para sempre obscurecer a senha, defina PasswordRevealMode como Oculto. A menos que você precise que a senha seja sempre obscurecida, você pode fornecer uma interface do usuário personalizada para permitir que o usuário alterne o PasswordRevealMode entre Oculto e Visível.

Nas versões anteriores do Windows Phone, o PasswordBox usava uma Caixa de Seleção para alternar se a senha estava obscurecida. Você pode criar uma interface do usuário semelhante para seu aplicativo, conforme mostrado no exemplo. Você também pode usar outros controles, como ToggleButton, para deixar os usuários alternarem os modos.

Uma caixa de senha com uma alternância de revelação personalizada.

Aplica-se a

Confira também