TextBox.PasswordChar Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

TextBox.cs

Dient zum Abrufen oder Festlegen des Zeichens, das zum Maskieren von Zeichen eines Kennworts in einem einzeiligen TextBox Steuerelement verwendet wird.

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

Eigenschaftswert

Char

Das Zeichen, das zum Maskieren von Zeichen verwendet wird, die in einem einzeiligen TextBox Steuerelement eingegeben wurden. Legen Sie den Wert dieser Eigenschaft auf "0" (U+0000) fest, wenn das Steuerelement zeichen bei der Eingabe nicht maskieren soll. Der Standardwert ist "0" (U+0000).

Beispiele

Im folgenden Codebeispiel wird ein TextBox Steuerelement erstellt, das zum Akzeptieren eines Kennworts verwendet wird. In diesem Beispiel wird die CharacterCasing Eigenschaft verwendet, um alle eingegebenen Zeichen in Kleinbuchstaben zu ändern, und die MaxLength Eigenschaft, um die Kennwortlänge auf acht Zeichen einzuschränken. In diesem Beispiel wird auch die TextAlign Eigenschaft verwendet, um das Kennwort im TextBox Steuerelement zu zentrieren.

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

Hinweise

Die UseSystemPasswordChar Eigenschaft hat Vorrang vor der PasswordChar Eigenschaft. Wird das UseSystemPasswordChartrueStandardkennwortzeichen verwendet, wird das Standardkennwortzeichen verwendet, und alle Zeichensätze werden PasswordChar ignoriert.

Wenn die PasswordChar Eigenschaft festgelegt ist, können Ausschneiden und Kopieren von Aktionen im Steuerelement mithilfe der Tastatur nicht ausgeführt werden.

Von Bedeutung

Wenn sich das TextBox Kennwort im Kennwortmodus befindet, weil UseSystemPasswordCharPasswordChar, oder ReadOnly ist es TextBox sich im trueeingeschränkten Modus befindet. In diesem Modus ist die ImeMode Einstellung deaktiviert, aber der Aktuelle ImeMode wird zwischengespeichert, sodass sie wiederhergestellt werden kann, wenn dies TextBox jemals uneingeschränkt wird. Das Umschalten ist ReadOnly ein häufiges Szenario. Die ImeMode Wird abgeschattet, während sich das Steuerelement im eingeschränkten Modus befindet. Aus der Designerperspektive ist der ImeMode angezeigte Wert der tatsächliche Wert.