PasswordBox.PasswordRevealMode プロパティ

定義

名前空間:

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

注釈

パスワードを隠すために使用する文字を変更するには、 PasswordChar プロパティを設定します。

注意

PasswordRevealMode は IsPasswordRevealButtonEnabled に置き換えられ、ユーザーが自分のパスワードを表示する方法に関するより多くのオプションが提供されます。 IsPasswordRevealButtonEnabled プロパティは無視されます。

プレビュー モード

既定で表示されるパスワード表示ボタン ("プレビュー" ボタン) では、 ユーザーがパスワードを表示するにはボタンを押し続けなければならないため、高レベルのセキュリティが維持されます。

このプロパティの値は、パスワード表示ボタンがユーザーに表示されるかどうかを決定する唯一の要素ではありません。 その他の要因としては、コントロールが最小幅より上に表示されるかどうか、 PasswordBox にフォーカスがあるかどうか、テキスト入力フィールドに少なくとも 1 つの文字が含まれているかどうかなどがあります。 セキュリティ上の理由から、パスワード表示ボタンは、 PasswordBox が初めてフォーカスを受け取り、文字が入力されたときにのみ表示されます。 PasswordBox でフォーカスが失われ、フォーカスが回復した場合、パスワードがクリアされ、文字入力がやり直されない限り、表示ボタンは再び表示されません。

非表示モードと表示モード

もう 1 つの PasswordRevealMode 列挙値 と Visibleは、パスワード表示ボタンを非表示にし、Hiddenパスワードが隠されているかどうかをプログラムで管理できるようにします。

常にパスワードを隠すには、 を に設定 PasswordRevealMode します Hidden。 パスワードを常に隠す必要がない限り、ユーザーが と Visibleを切り替えることができるカスタム UI をPasswordRevealModeHidden提供できます。 CheckBox を使用してパスワードが隠れているかどうかを切り替える方法については、「例」セクションを参照してください。 ToggleButton などのその他のコントロールを使ってユーザーがモードを切り替えられるようにすることもできます。

こちらもご覧ください

• PasswordRevealMode