TextBox.PasswordChar Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property PasswordChar As CharValore della proprietà
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.
