TextBox.PasswordChar Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das Zeichen ab, mit dem Zeichen eines Kennworts in einem einzeiligen TextBox-Steuerelement maskiert werden, oder legt dieses fest.

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, mit dem Zeichen maskiert werden, die in einem einzeiligen TextBox-Steuerelement eingegeben werden. Legen Sie den Wert dieser Eigenschaft auf "0" (U+0000) fest, wenn das Steuerelement zeichen während 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 zu beschrä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. Jedes Mal, wenn auf UseSystemPasswordChartruefestgelegt ist, wird das Standardkennwortzeichen des Systems verwendet, und alle zeichen, die von PasswordChar festgelegt werden, werden ignoriert.

Wenn die PasswordChar -Eigenschaft festgelegt ist, können Ausschneid- und Kopieraktionen im Steuerelement über die Tastatur nicht ausgeführt werden.

Wichtig

Wenn sich im TextBox Kennwortmodus befindet, da PasswordChar, UseSystemPasswordCharoder ReadOnly ist, befindet truesich der TextBox im eingeschränkten Modus. In diesem Modus ist deaktiviert ImeMode , aber der aktuelle ImeMode wird zwischengespeichert, sodass er wiederhergestellt werden kann, wenn der TextBox jemals uneingeschränkt wird. Das Umschalten von ReadOnly ist ein häufiges Szenario. Die ImeMode wird überschatten, während sich das Steuerelement im eingeschränkten Modus befindet. Aus Sicht des Designers ist der ImeMode angezeigte Wert der tatsächliche Wert.