Compartir a través de


PasswordBox.PasswordRevealMode Propiedad

Definición

Obtiene o establece un valor que especifica si la contraseña siempre, nunca o está oculta opcionalmente.

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 de propiedad

Valor de la enumeración que especifica si la contraseña siempre, nunca o está oculta opcionalmente. El valor predeterminado es Peek.

Ejemplos

En este ejemplo se muestra cómo usar un CheckBox para permitir que un usuario cambie el modo reveal de 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;
    }
}
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

Comentarios

PasswordRevealMode reemplaza a IsPasswordRevealButtonEnabled para ofrecerte más opciones para ver la contraseña del usuario. Se omite la propiedad IsPasswordRevealButtonEnabled .

Para cambiar el carácter usado para ocultar la contraseña, establezca la propiedad PasswordChar .

Modo de información

De manera predeterminada, se muestra el botón Mostrar (o botón "ojear"). El usuario debe presionar continuamente el botón para ver la contraseña, de modo que se mantiene un alto nivel de seguridad.

Cuadro de contraseña con la contraseña que se muestra.

El valor de esta propiedad no es el único factor que determina si un botón mostrar contraseña es visible para el usuario. Otros factores incluyen si el control se muestra por encima de un ancho mínimo, si passwordBox tiene el foco y si el campo de entrada de texto contiene al menos un carácter. Tenga en cuenta que, debido a motivos de seguridad, el botón Mostrar contraseña solo se muestra cuando passwordBox recibe el foco por primera vez y se escribe un carácter. Si passwordBox pierde el foco y, a continuación, recupera el foco, el botón Mostrar no se muestra de nuevo a menos que se borre la contraseña y se inicie la entrada de caracteres.

Nota:

Antes de Windows 10, el botón Mostrar contraseña no se mostraba de forma predeterminada. Si la seguridad de la aplicación requiere que la contraseña siempre esté oculta, asegúrese de establecer PasswordRevealMode en Oculto.

Modos Oculta y Visible

Otros valores de enumeración de la propiedad PasswordRevealMode, como Oculta y Visible, ocultan el botón para mostrar la contraseña y te permiten decidir mediante programación si la contraseña debe permanecer oculta.

Para ocultar siempre la contraseña, establezca PasswordRevealMode en Oculto. A menos que necesite que la contraseña esté siempre oculta, puede proporcionar una interfaz de usuario personalizada para permitir que el usuario cambie passwordRevealMode entre Hidden y Visible.

En versiones anteriores de Windows Phone, PasswordBox usaba un CheckBox para alternar si la contraseña estaba oculta. Puede crear una interfaz de usuario similar para la aplicación, como se muestra en el ejemplo. Asimismo, también puedes usar otros controles, como ToggleButton, para permitir al usuario cambiar de modo.

Cuadro de contraseña con un botón de alternancia reveal personalizado.

Se aplica a

Consulte también