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 é Pré-visualizar.

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

Comentários

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

Observação

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

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.

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. Por motivos de segurança, o botão de revelação de senha é mostrado somente quando o 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.

Uma caixa de senha com a senha mostrada.

Modos ocultos e visíveis

Os outros valores Hidden de enumeração PasswordRevealMode e Visible, ocultam o botão de revelação de senha e permitem que você gerencie programaticamente se a senha está obscurecida.

Para sempre obscurecer a senha, defina PasswordRevealMode como Hidden. 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 entre PasswordRevealModeHidden e Visible. Consulte a seção Exemplos para ver como usar uma Caixa de Seleção para alternar se a senha está ocultada ou não. 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