PasswordBox.PasswordRevealMode 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

获取或设置一个值，该值指定密码是始终、从不还是选择性地被遮盖。

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

属性值

PasswordRevealMode

枚举的一个值，该值指定密码是始终、从不还是选择性地被遮盖。 默认值为 速览。

示例

此示例演示如何使用 CheckBox 让用户切换 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;
    }
}

注解

若要更改用于隐藏密码的字符，请设置 PasswordChar 属性。

注意

PasswordRevealMode 取代 了 IsPasswordRevealButtonEnabled ，为你提供更多用户如何查看其密码的选项。 将忽略 IsPasswordRevealButtonEnabled 属性。

速览模式

默认情况下，会显示密码显示按钮（或“速览”按钮）。 用户必须持续按住按钮来查看密码，以便保持较高级别的安全性。

此属性的值不是确定密码显示按钮是否对用户可见的唯一因素。 其他因素包括控件是否显示在最小宽度上方、 PasswordBox 是否具有焦点以及文本输入字段是否至少包含一个字符。 出于安全原因，仅当 PasswordBox 首次获得焦点并输入字符时，才会显示密码显示按钮。 如果 PasswordBox 失去焦点，然后重新获得焦点，则除非清除密码并重新开始字符输入，否则不会再次显示“显示”按钮。

隐藏和可见模式

其他 PasswordRevealMode 枚举值 Hidden 和 Visible，隐藏密码显示按钮，并允许以编程方式管理密码是否被遮盖。

若要始终隐藏密码，请将 设置为 PasswordRevealModeHidden。 除非需要始终遮盖密码，否则可以提供一个自定义 UI，让用户在 和 Visible之间Hidden切换 PasswordRevealMode 。 请参阅示例部分，了解如何使用 CheckBox 切换密码是否被遮盖。 你还可以使用其他控件（例如 ToggleButton）以使用户切换模式。

另请参阅

• PasswordRevealMode