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 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 Hidden
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 PasswordRevealMode
Hidden
. A menos que necesite que la contraseña esté siempre oculta, puede proporcionar una interfaz de usuario personalizada para permitir al usuario alternar entre PasswordRevealMode
Hidden
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.