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

Comentarios

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

Note

PasswordRevealMode reemplaza a IsPasswordRevealButtonEnabled para ofrecerle más opciones para ver su contraseña. Se omite la propiedad IsPasswordRevealButtonEnabled .

Modo de vistazo

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

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. Por 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.

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

Modos ocultos y visibles

Los demás valores Hidden de enumeración PasswordRevealMode y Visible, ocultan el botón mostrar contraseña y permiten administrar mediante programación si la contraseña está oculta.

Para ocultar siempre la contraseña, establezca en PasswordRevealModeHidden. A menos que necesite que la contraseña esté siempre oculta, puede proporcionar una interfaz de usuario personalizada para permitir que el usuario cambie entre PasswordRevealModeHidden y Visible. Consulte la sección Ejemplos para ver cómo usar una casilla para alternar si la contraseña está oculta o no. También puede usar otros controles, como ToggleButton, para permitir que el usuario cambie los modos.

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

Se aplica a

Consulte también