TextBox.PasswordChar-Eigenschaft

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property PasswordChar As Char
'Usage
Dim instance As TextBox
Dim value As Char

value = instance.PasswordChar

instance.PasswordChar = value

[LocalizableAttribute(true)] 
public char PasswordChar { get; set; }

[LocalizableAttribute(true)] 
public:
property wchar_t PasswordChar {
    wchar_t get ();
    void set (wchar_t value);
}

/** @property */
public char get_PasswordChar ()

/** @property */
public void set_PasswordChar (char value)

public function get PasswordChar () : char

public function set PasswordChar (value : char)

Eigenschaftenwert

Das Zeichen, mit dem Zeichen maskiert werden, die in einem einzeiligen TextBox-Steuerelement eingegeben werden. Legt den Wert dieser Eigenschaft auf 0 (Zeichenwert) fest, wenn im Steuerelement keine Zeichen bei der Eingabe maskiert werden sollen. Ist standardmäßig gleich dem Zeichenwert 0 (null).

Hinweise

Die UseSystemPasswordChar-Eigenschaft hat Vorrang gegenüber der PasswordChar-Eigenschaft. Wenn UseSystemPasswordChar auf true festgelegt wurde, wird das Standardkennwortzeichen des Systems verwendet, und sämtliche von PasswordChar festgelegten Zeichen werden ignoriert.

Wenn die Multiline-Eigenschaft auf true festgelegt ist, hat das Festlegen der PasswordChar-Eigenschaft keine sichtbaren Auswirkungen. Wenn die PasswordChar-Eigenschaft auf true festgelegt ist, können mit der Tastatur keine Aktionen zum Ausschneiden, Kopieren und Einfügen im Steuerelement ausgeführt werden, unabhängig davon, ob die Multiline-Eigenschaft auf true oder false festgelegt wurde.

Beispiel

Im folgenden Codebeispiel wird ein TextBox-Steuerelement erstellt, das zum Akzeptieren eines Kennworts verwendet wird. In diesem Beispiel werden mit der CharacterCasing-Eigenschaft alle Zeichen in Großbuchstaben umgewandelt, und mit der MaxLength-Eigenschaft wird die Kennwortlänge auf acht Zeichen beschränkt. In diesem Beispiel wird des Weiteren die TextAlign-Eigenschaft verwendet, um das Kennwort im TextBox-Steuerelement zu zentrieren.

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

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:
   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.set_MaxLength(8);
    // Assign the asterisk to be the password character.
    textBox1.set_PasswordChar('*');
    // Change all text entered to be lowercase.
    textBox1.set_CharacterCasing(CharacterCasing.Lower);
    // Align the text in the center of the TextBox control.
    textBox1.set_TextAlign(HorizontalAlignment.Center);
} //CreateMyPasswordTextBox

public function CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    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;
 }
 

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextBox-Klasse
TextBox-Member
System.Windows.Forms-Namespace