PasswordBox.PasswordRevealMode Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

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

PasswordRevealMode

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

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 .

Nota

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

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.

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 vuelve a mostrar a menos que se borre la contraseña y se inicie la entrada de caracteres.

Modos Oculta y Visible

Los demás valores de enumeración PasswordRevealMode y HiddenVisible, 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 al usuario alternar 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. Asimismo, también puedes usar otros controles, como ToggleButton, para permitir al usuario cambiar de modo.

Consulte también

• PasswordRevealMode