PasswordBox.PasswordRevealMode Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
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.