PasswordBox.PasswordRevealMode Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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;
}
}
Keterangan
Untuk mengubah karakter yang digunakan untuk mengaburkan kata sandi, atur properti PasswordChar .
Catatan
PasswordRevealMode menggantikan IsPasswordRevealButtonEnabled untuk memberi Anda lebih banyak opsi tentang bagaimana pengguna dapat melihat kata sandi mereka. Properti IsPasswordRevealButtonEnabled diabaikan.
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. Untuk 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.
Mode Tersembunyi dan Terlihat
Nilai enumerasi PasswordRevealMode lainnya, Hidden
dan Visible
, sembunyikan tombol ungkap kata sandi dan memungkinkan Anda mengelola secara terprogram apakah kata sandi dikaburkan.
Untuk selalu mengaburkan kata sandi, atur PasswordRevealMode
ke Hidden
. Kecuali Anda memerlukan kata sandi untuk selalu dikaburkan, Anda dapat menyediakan UI kustom untuk membiarkan pengguna beralih PasswordRevealMode
antara Hidden
dan Visible
. Lihat bagian Contoh untuk melihat cara menggunakan Kotak Centang untuk beralih apakah kata sandi dikaburkan atau tidak. Anda juga dapat menggunakan kontrol lain, seperti ToggleButton, untuk membiarkan pengguna beralih mode.