TextBox.PasswordChar Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta il carattere utilizzato per mascherare i caratteri di una password in un controllo TextBox a riga singola.

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

Valore della proprietà

Char

Il carattere utilizzato per mascherare i caratteri di una password in un controllo TextBox a riga singola. Impostare il valore di questa proprietà su '0' (U+0000) se non si desidera che il controllo maschera i caratteri durante la digitazione. Il valore predefinito è '0' (U+0000).

Esempio

Nell'esempio di codice seguente viene creato un TextBox controllo utilizzato per accettare una password. In questo esempio viene utilizzata la CharacterCasing proprietà per modificare tutti i caratteri digitati in lettere minuscole e la MaxLength proprietà per limitare la lunghezza della password a otto caratteri. In questo esempio viene usata anche la TextAlign proprietà per centrare la password nel TextBox controllo .

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

Commenti

La UseSystemPasswordChar proprietà ha la precedenza sulla PasswordChar proprietà . UseSystemPasswordChar Ogni volta che è impostato su true, viene utilizzato il carattere password di sistema predefinito e qualsiasi set di caratteri da PasswordChar viene ignorato.

Quando la PasswordChar proprietà è impostata, non è possibile eseguire azioni taglia e copia nel controllo utilizzando la tastiera.

Importante

Quando è TextBox in modalità password perché PasswordChar, UseSystemPasswordCharo ReadOnly è true, è TextBox in modalità con restrizioni. In questa modalità, l'oggetto ImeMode è disabilitato, ma l'oggetto corrente ImeMode viene memorizzato nella cache in modo che possa essere ripristinato se l'oggetto TextBox diventa sempre senza restrizioni. L'attivazione o disattivazione di ReadOnly è uno scenario comune. L'oggetto ImeMode è ombreggiato mentre il controllo è in modalità con restrizioni. Dal punto di vista della finestra di progettazione, il ImeMode valore visualizzato è il valore effettivo.