TextBox.PasswordChar 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置字符，该字符用于屏蔽单行 TextBox 控件中的密码字符。

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

属性值

Char

用于屏蔽在单行 TextBox 控件中输入的字符的字符。 如果不希望控件在键入字符时屏蔽字符，请将此属性的值设置为“0” (U+0000) 。 默认值为“0” (U+0000) 。

示例

下面的代码示例创建一个 TextBox 用于接受密码的 控件。 此示例使用 CharacterCasing 属性将键入的所有字符更改为小写，并使用 MaxLength 属性将密码长度限制为 8 个字符。 此示例还使用 TextAlign 属性在 控件中 TextBox 将密码居中。

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

注解

属性 UseSystemPasswordChar 优先于 PasswordChar 属性。 每当 UseSystemPasswordChar 设置为 true时，将使用默认的系统密码字符，并忽略由 PasswordChar 设置的任何字符。

PasswordChar设置 属性后，无法使用键盘在控件中执行剪切和复制操作。

重要

TextBox当 由于 PasswordChar、 UseSystemPasswordChar或 ReadOnly 为 true而处于密码模式时， TextBox 处于受限模式。 在此模式下， ImeMode 禁用，但缓存当前 ImeMode ，以便在 变为不受限制时 TextBox 可以还原它。 切换 ReadOnly 是一种常见方案。 当 ImeMode 控件处于受限模式时，将隐藏 。 从设计器的角度来看， ImeMode 显示的值是实际值。