다음을 통해 공유


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

속성 값

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

예제

이 예제에서는 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으로 설정해야 합니다.

숨김 및 표시 모드

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

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

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

사용자 지정 표시 토글이 있는 암호 상자입니다.

적용 대상

추가 정보