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 にフォーカスがあるかどうか、テキスト入力フィールドに少なくとも 1 文字が含まれているかどうかなどがあります。 セキュリティ上の理由から、パスワード表示ボタンは、 PasswordBox が初めてフォーカスを受け取り、文字が入力された場合にのみ表示されることに注意してください。 PasswordBox がフォーカスを失い、フォーカスが回復した場合、パスワードがクリアされ、文字入力がやり直されない限り、表示ボタンは再び表示されません。

注意

Windows 10より前は、パスワード表示ボタンは既定では表示されませんでした。 アプリのセキュリティでパスワードが常に隠されている必要がある場合は、必ず PasswordRevealMode を [非表示] に設定してください。

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

PasswordRevealMode には、そのほかに Hidden と Visible という列挙値があります。これらの列挙値を使うと、パスワード表示ボタンを非表示にして、パスワードを非表示にするかどうかをプログラムで管理できます。

常にパスワードを隠すには、PasswordRevealMode を [非表示] に設定します。 パスワードを常に隠す必要がない限り、カスタム UI を指定して、ユーザーが PasswordRevealMode を [非表示 ] と [ 表示] の間で切り替えることができます。

以前のバージョンのWindows Phoneでは、PasswordBox は CheckBox を使用して、パスワードが隠れているかどうかを切り替えていました。 この例に示すように、アプリ用に同様の UI を作成できます。 ToggleButton などのその他のコントロールを使ってユーザーがモードを切り替えられるようにすることもできます。

こちらもご覧ください

• PasswordRevealMode