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

암호가 항상, 절대로 또는 선택적으로 가려지는지 여부를 지정하는 열거형의 값입니다. 기본값은 Peek 입니다.

예제

이 예제에서는 사용자가 표시 모드PasswordBox를 CheckBox 전환할 수 있도록 하는 방법을 보여줍니다.

<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 으로 설정해야 합니다.

숨김 및 표시 모드

다른 PasswordRevealMode 열거형 값인 숨김 및 표시 는 암호 표시 단추를 숨기고 암호가 가려지는지 여부를 프로그래밍 방식으로 관리할 수 있습니다.

암호를 항상 모호하게 하려면 PasswordRevealMode를 숨김 으로 설정합니다. 암호를 항상 가려야 하는 경우가 아니면 사용자가 Hidden 과 Visible 간에 PasswordRevealMode를 토글할 수 있도록 사용자 지정 UI를 제공할 수 있습니다.

이전 버전의 Windows Phone PasswordBox 암호가 CheckBox 가려졌는지 여부를 토글하는 데 사용했습니다. 예제와 같이 앱에 대해 유사한 UI를 만들 수 있습니다. 다른 컨트롤(예: ToggleButton)을 사용하여 사용자가 모드를 전환하도록 할 수도 있습니다.

추가 정보

• PasswordRevealMode