다음을 통해 공유


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

설명

암호를 가리는 데 사용되는 문자를 변경하려면 PasswordChar 속성을 설정합니다.

참고

PasswordRevealMode 는 IsPasswordRevealButtonEnabled 를 대체하여 사용자가 암호를 볼 수 있는 방법에 대한 추가 옵션을 제공합니다. IsPasswordRevealButtonEnabled 속성은 무시됩니다.

미리 보기 모드

기본적으로 암호 표시 단추(또는 "미리 보기" 단추)가 표시됩니다. 사용자는 암호를 보기 위해 단추를 계속 눌러야 하므로 높은 수준의 보안이 유지됩니다.

이 속성의 값은 암호 표시 단추가 사용자에게 표시되는지 여부를 결정하는 유일한 요소가 아닙니다. 다른 요인으로는 컨트롤이 최소 너비 이상으로 표시되는지 여부, PasswordBox 에 포커스가 있는지 여부 및 텍스트 입력 필드에 하나 이상의 문자가 포함되어 있는지 여부가 포함됩니다. 보안상의 이유로 암호 표시 단추는 PasswordBox 가 처음으로 포커스를 받고 문자를 입력한 경우에만 표시됩니다. PasswordBox가 포커스를 잃고 포커스를 다시 얻으면 암호가 지워지고 문자 입력이 다시 시작되지 않는 한 표시 단추가 다시 표시되지 않습니다.

암호가 표시된 암호 상자입니다.

숨김 및 표시 모드

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

항상 암호를 가리려면 를 로 Hidden설정합니다PasswordRevealMode. 암호를 항상 가려야 하는 경우가 아니면 사용자 지정 UI를 제공하여 사용자가 와 Visible사이 Hidden 를 전환 PasswordRevealMode 할 수 있도록 할 수 있습니다. CheckBox를 사용하여 암호가 가려지는지 여부를 전환하는 방법을 보려면 예제 섹션을 참조하세요. ToggleButton과 같은 기타 컨트롤을 사용하여 사용자가 모드 간을 전환하도록 할 수도 있습니다.

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

적용 대상

추가 정보