PasswordBox.PasswordRevealMode Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau menetapkan nilai yang menentukan apakah kata sandi selalu, tidak pernah, atau secara opsional dikaburkan.

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

Nilai Properti

PasswordRevealMode

Nilai enumerasi yang menentukan apakah kata sandi selalu, tidak pernah, atau secara opsional dikaburkan. Defaultnya adalah Intip.

Contoh

Contoh ini menunjukkan cara menggunakan Kotak Centang untuk memungkinkan pengguna mengalihkan mode pengungkapan 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

Keterangan

PasswordRevealMode menggantikan IsPasswordRevealButtonEnabled untuk memberi Anda lebih banyak opsi tentang bagaimana pengguna dapat melihat kata sandi mereka. Properti IsPasswordRevealButtonEnabled diabaikan.

Untuk mengubah karakter yang digunakan untuk mengaburkan kata sandi, atur properti PasswordChar .

Mode intip

Secara default, tombol ungkap kata sandi (atau tombol "intip") ditampilkan. Pengguna harus terus menekan tombol untuk melihat kata sandi, sehingga tingkat keamanan yang tinggi dipertahankan.

Nilai properti ini bukan satu-satunya faktor yang menentukan apakah tombol ungkap kata sandi terlihat oleh pengguna. Faktor lain termasuk apakah kontrol ditampilkan di atas lebar minimum, apakah Kotak Kata Sandi memiliki fokus, dan apakah bidang entri teks berisi setidaknya satu karakter. Perhatikan bahwa karena alasan keamanan, tombol ungkap kata sandi hanya ditampilkan saat Kotak Kata Sandi menerima fokus untuk pertama kalinya dan karakter dimasukkan. Jika PasswordBox kehilangan fokus lalu mendapatkan kembali fokus, tombol ungkapkan tidak ditampilkan lagi kecuali kata sandi dibersihkan dan entri karakter dimulai kembali.

Catatan

Sebelum Windows 10, tombol ungkap kata sandi tidak ditampilkan secara default. Jika keamanan aplikasi Anda mengharuskan kata sandi selalu dikaburkan, pastikan untuk mengatur PasswordRevealMode ke Tersembunyi.

Mode Tersembunyi dan Terlihat

Nilai enumerasi PasswordRevealMode lainnya, Tersembunyi dan Terlihat, menyembunyikan tombol ungkap kata sandi dan memungkinkan Anda mengelola secara terprogram apakah kata sandi dikaburkan.

Untuk selalu mengaburkan kata sandi, atur PasswordRevealMode ke Tersembunyi. Kecuali Anda memerlukan kata sandi untuk selalu dikaburkan, Anda dapat menyediakan UI kustom untuk membiarkan pengguna mengalihkan PasswordRevealMode antara Tersembunyi dan Terlihat.

Di versi Windows Phone sebelumnya, PasswordBox menggunakan Kotak Centang untuk mengalihkan apakah kata sandi dikaburkan. Anda dapat membuat UI serupa untuk aplikasi Anda, seperti yang ditunjukkan dalam contoh. Anda juga dapat menggunakan kontrol lain, seperti ToggleButton, untuk membiarkan pengguna beralih mode.

Lihat juga

• PasswordRevealMode