TextBox.PasswordChar TextBox.PasswordChar TextBox.PasswordChar TextBox.PasswordChar Property

정의

한 줄만 입력할 수 있는 TextBox 컨트롤에서 암호 문자를 마스킹하는 데 사용되는 문자를 가져오거나 설정합니다.Gets or sets the character used to mask characters of a password in a single-line TextBox control.

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

속성 값

한 줄만 입력할 수 있는 TextBox 컨트롤에 입력한 문자를 마스킹하는 데 사용되는 문자입니다.The character used to mask characters entered in a single-line TextBox control. 입력 된 문자를 컨트롤에서 마스킹 하지 않으려면이 속성의 값을 ' 0 ' (U + 0000)으로 설정 합니다.Set the value of this property to '0' (U+0000) if you do not want the control to mask characters as they are typed. 기본값은 ' 0 ' (U + 0000)입니다.The default value is '0' (U+0000).

예제

다음 코드 예제는 TextBox 암호를 적용 하는 데 사용 되는 컨트롤입니다.The following code example creates a TextBox control that is used to accept a password. 이 예제에서는 합니다 CharacterCasing 소문자로 입력 한 모든 문자를 변경 하려면 속성 및 MaxLength 암호는 길이가 8 자로 제한 하는 속성입니다.This example uses the CharacterCasing property to change all characters typed to lowercase and the MaxLength property to restrict the password length to eight characters. 또한이 예제에서는 합니다 TextAlign 속성에 암호를 가운데를 TextBox 컨트롤입니다.This example also uses the TextAlign property to center the password in the TextBox control.

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 속성입니다.The UseSystemPasswordChar property has precedence over the PasswordChar property. 때마다 합니다 UseSystemPasswordChar 로 설정 된 true, 기본 시스템 암호 문자는 및 설정 된 모든 문자가 PasswordChar 무시 됩니다.Whenever the UseSystemPasswordChar is set to true, the default system password character is used and any character set by PasswordChar is ignored.

경우는 PasswordChar 속성을 설정, 키보드를 사용 하 여 컨트롤의 잘라내기 및 복사 작업을 수행할 수 없습니다.When the PasswordChar property is set, cut and copy actions in the control using the keyboard cannot be performed.

중요

경우는 TextBox 있으므로 암호 모드 PasswordChar, UseSystemPasswordChar, 또는 ReadOnlytrue, TextBox 제한 모드.When the TextBox is in password mode because PasswordChar, UseSystemPasswordChar, or ReadOnly is true, the TextBox is in restricted mode. 이 모드에서는 합니다 ImeMode 사용 안 함, 이지만 현재 ImeMode 경우 복원할 수 있도록 캐시 됩니다는 TextBox 무제한 수입니다.In this mode, the ImeMode is disabled, but the current ImeMode is cached so that it can be restored if the TextBox ever becomes unrestricted. 설정/해제는 ReadOnly 일반적인 시나리오입니다.Toggling the ReadOnly is a common scenario. ImeMode 가 제한 된 모드에서 컨트롤은 숨겨집니다.The ImeMode is shadowed while the control is in restricted mode. 디자이너의 관점에서을 ImeMode 표시 된 값은 실제 값입니다.From the designer perspective, the ImeMode value shown is the actual value.

적용 대상