TextBox.PasswordChar Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

TextBox.cs

Mendapatkan atau mengatur karakter yang digunakan untuk menutupi karakter kata sandi dalam kontrol satu baris TextBox .

public:
 property char PasswordChar { char get(); void set(char value); };

public char PasswordChar { get; set; }

member this.PasswordChar : char with get, set

Public Property PasswordChar As Char

Nilai Properti

Char

Karakter yang digunakan untuk menutupi karakter yang dimasukkan dalam kontrol satu baris TextBox . Atur nilai properti ini ke '0' (U+0000) jika Anda tidak ingin kontrol menutupi karakter saat diketik. Nilai defaultnya adalah '0' (U+0000).

Contoh

Contoh kode berikut membuat TextBox kontrol yang digunakan untuk menerima kata sandi. Contoh ini menggunakan properti untuk mengubah semua karakter yang CharacterCasing ditik menjadi huruf kecil dan MaxLength properti untuk membatasi panjang kata sandi menjadi delapan karakter. Contoh ini juga menggunakan properti untuk mempusatkan TextAlign kata sandi dalam TextBox kontrol.

public:
   void CreateMyPasswordTextBox()
   {
      // Create an instance of the TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      // Set the maximum length of text in the control to eight.
      textBox1->MaxLength = 8;
      // Assign the asterisk to be the password character.
      textBox1->PasswordChar = '*';
      // Change all text entered to be lowercase.
      textBox1->CharacterCasing = CharacterCasing::Lower;
      // Align the text in the center of the TextBox control.
      textBox1->TextAlign = HorizontalAlignment::Center;
   }

public void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1.PasswordChar = '*';
    // Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Lower;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }

Public Sub CreateMyPasswordTextBox()
    ' Create an instance of the TextBox control.
    Dim textBox1 As New TextBox()
    ' Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8
    ' Assign the asterisk to be the password character.
    textBox1.PasswordChar = "*"c
    ' Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Lower
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

Keterangan

Properti UseSystemPasswordChar lebih diutamakan daripada PasswordChar properti . UseSystemPasswordChar Setiap kali diatur ke true, karakter kata sandi sistem default digunakan dan karakter apa pun yang diatur oleh PasswordChar diabaikan.

PasswordChar Ketika properti diatur, tindakan potong dan salin di kontrol menggunakan keyboard tidak dapat dilakukan.

Penting

TextBox Ketika berada dalam mode kata sandi karena PasswordChar, , UseSystemPasswordCharatau ReadOnly adalah true, TextBox dalam mode terbatas. Dalam mode ini, dinonaktifkan ImeMode , tetapi saat ini ImeMode di-cache sehingga dapat dipulihkan jika TextBox pernah menjadi tidak terbatas. Beralih adalah ReadOnly skenario umum. ImeMode bayangan saat kontrol dalam mode terbatas. Dari perspektif perancang, nilai yang ImeMode ditampilkan adalah nilai aktual.