PasswordBox.PasswordRevealMode Свойство

Определение

Пространство имен:

Windows.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;
    }
}

Private Sub CheckBox_Changed(sender As Object, e As RoutedEventArgs)
    If revealModeCheckBox.IsChecked = True Then
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Visible
    Else
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Hidden
    End If
End Sub

Комментарии

PasswordRevealMode заменяет IsPasswordRevealButtonEnabled , предоставляя дополнительные возможности для просмотра пароля пользователем. Свойство IsPasswordRevealButtonEnabled игнорируется.

Чтобы изменить символ, используемый для скрытия пароля, задайте свойство PasswordChar .

Режим временного просмотра

По умолчанию кнопка показа пароля (или кнопка «Подсмотреть») отображается. Пользователь должен удерживать эту кнопку для просмотра пароля, чтобы поддерживать высокий уровень безопасности.

Значение этого свойства не является единственным фактором, определяющим, является ли кнопка отображения пароля видимой для пользователя. Другие факторы включают в себя, отображается ли элемент управления выше минимальной ширины, имеет ли элемент PasswordBox фокус и содержит ли поле ввода текста хотя бы один символ. Обратите внимание, что по соображениям безопасности кнопка отображения пароля отображается только в том случае, если элемент PasswordBox получает фокус в первый раз и вводится символ. Если элемент PasswordBox теряет фокус, а затем восстанавливает фокус, кнопка отображения не отображается снова, если пароль не будет снят, а ввод символов не начнется заново.

Примечание

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

Режимы Hidden и Visible

Другие значения перечисления PasswordRevealMode — Hidden и Visible — скрывают кнопку показа пароля и позволяют программно управлять видимостью пароля.

Чтобы всегда скрывать пароль, установите для параметра PasswordRevealMode значение Скрыто. Если вам не требуется всегда скрывать пароль, вы можете предоставить пользовательский интерфейс, чтобы пользователь переключил PasswordRevealMode между Скрытым и Видимым.

В предыдущих версиях Windows Phone PasswordBox использовал checkBox для переключения на скрытие пароля. Вы можете создать аналогичный пользовательский интерфейс для приложения, как показано в примере. Чтобы позволить пользователю переключать режимы, можно использовать и другие элементы управления, например ToggleButton.

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

• PasswordRevealMode