PasswordBox.PasswordRevealMode Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, является ли пароль всегда, никогда или при необходимости скрыт.
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
Значение свойства
Значение перечисления , указывающее, является ли пароль всегда, никогда или при необходимости скрыт. Значение по умолчанию — Обзор.
Примеры
В этом примере показано, как использовать 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 и Hidden
Visible
, скрывают кнопку отображения пароля и позволяют программно управлять скрытием пароля.
Чтобы всегда скрывать пароль, задайте для значение PasswordRevealMode
Hidden
. Если пароль не должен быть всегда скрыт, можно предоставить пользовательский интерфейс, позволяющий пользователю переключаться PasswordRevealMode
между Hidden
и Visible
. Ознакомьтесь с разделом Примеры, чтобы узнать, как использовать checkBox для переключения на скрытие пароля. Чтобы позволить пользователю переключать режимы, можно использовать и другие элементы управления, например ToggleButton.