TextBox.PasswordChar Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Tek satırlı TextBox denetimde parolanın karakterlerini maskelerken kullanılan karakteri alır veya ayarlar.

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

Özellik Değeri

Char

Tek satırlı TextBox denetime girilen karakterleri maskelerken kullanılan karakter. Denetimin yazılan karakterleri maskelemesini istemiyorsanız bu özelliğin değerini '0' (U+0000) olarak ayarlayın. Varsayılan değer : '0' (U+0000).

Örnekler

Aşağıdaki kod örneği, parola kabul etmek için kullanılan bir TextBox denetim oluşturur. Bu örnekte, küçük harfe yazılan tüm karakterleri değiştirmek için özelliğini ve MaxLength parola uzunluğunu sekiz karakterle kısıtlamak için özelliği kullanılırCharacterCasing. Bu örnekte, denetimdeki parolayı TextAlignTextBox ortalamak için özelliği de kullanılır.

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

Açıklamalar

özelliği UseSystemPasswordChar , özelliğine PasswordChar göre önceliklidir. UseSystemPasswordChar olarak ayarlandığındatrue, varsayılan sistem parolası karakteri kullanılır ve tarafından PasswordChar ayarlanan herhangi bir karakter yoksayılır.

PasswordChar Özellik ayarlandığında, klavyeyi kullanarak denetimdeki kesme ve kopyalama eylemleri gerçekleştirilemez.

Önemli

TextBox, UseSystemPasswordCharveya ReadOnly olduğundan parola modunda PasswordCharolduğundatrueTextBox, kısıtlanmış moddadır. Bu modda, ImeMode devre dışı bırakılır, ancak geçerli ImeMode önbelleklenir, böylece sınırsız hale gelirse TextBox geri yüklenebilir. geçişini yapmak ReadOnly yaygın bir senaryodur. ImeMode denetim kısıtlı moddayken gölgeli olur. Tasarımcı perspektifinden bakıldığında, ImeMode gösterilen değer gerçek değerdir.