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 теряет фокус, а затем восстанавливает фокус, кнопка отображения не отображается снова, если пароль не будет очищен и ввод символа не начнется заново.

Режимы Hidden и Visible

Другие значения перечисления PasswordRevealMode и HiddenVisible, скрывают кнопку отображения пароля и позволяют программно управлять скрытием пароля.

Чтобы всегда скрывать пароль, задайте для значение PasswordRevealModeHidden. Если пароль не должен быть всегда скрыт, можно предоставить пользовательский интерфейс, позволяющий пользователю переключаться PasswordRevealMode между Hidden и Visible. Ознакомьтесь с разделом Примеры, чтобы узнать, как использовать checkBox для переключения на скрытие пароля. Чтобы позволить пользователю переключать режимы, можно использовать и другие элементы управления, например ToggleButton.

См. также раздел

• PasswordRevealMode