다음을 통해 공유

TextBox.PasswordChar 속성

  • 아티클

한 줄만 입력할 수 있는 TextBox 컨트롤에서 암호 문자를 마스킹하는 데 사용되는 문자를 가져오거나 설정합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
<LocalizableAttribute(True)> _
Public Property PasswordChar As Char
‘사용 방법
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)

속성 값

한 줄만 입력할 수 있는 TextBox 컨트롤에 입력한 문자를 마스킹하는 데 사용되는 문자입니다. 컨트롤이 입력된 문자를 마스킹하지 않도록 하려면 이 속성 값을 0(문자 값)으로 설정합니다. 기본적으로 0(문자 값)이 적용됩니다.

설명

UseSystemPasswordChar 속성은 PasswordChar 속성에 우선합니다. UseSystemPasswordChar를 true로 설정하면 기본 시스템 암호 문자가 사용되고 PasswordChar에 설정된 모든 문자가 무시됩니다.

Multiline 속성이 true로 설정된 경우 PasswordChar 속성을 설정해도 시각적으로 영향을 주지 않습니다. PasswordChar 속성이 true로 설정된 경우에는 Multiline 속성이 true 또는 false로 설정되어 있는지에 관계없이 해당 컨트롤에서 키보드를 사용하여 잘라내기, 복사 및 붙여넣기 동작을 수행할 수 없습니다.

참고

일본어 운영 체제에서 PasswordChar는 Multiline 속성이 true 또는 false인지에 관계없이 적용됩니다. 다른 운영 체제에서는 Multiline이 false로 설정된 경우에만 PasswordChar가 적용됩니다.

중요

PasswordChar, UseSystemPasswordChar 또는 ReadOnly가 true로 설정되어 TextBox가 암호 모드로 지정되어 있으면 TextBox가 제한된 모드로 설정됩니다. 이 모드에서는 ImeMode가 사용되지 않지만 TextBox에 대한 제한이 해제될 경우 복원할 수 있도록 현재 ImeMode가 캐시됩니다. ReadOnly를 전환하는 경우를 예로 들 수 있습니다. 컨트롤이 제한된 모드에 있으면 ImeMode가 숨겨집니다. 디자이너의 입장에서는 표시되는 ImeMode 값이 실제 값입니다.

예제

다음 코드 예제에서는 암호를 입력하는 데 사용되는 TextBox 컨트롤을 만듭니다. 이 예제에서는 CharacterCasing 속성을 사용하여 입력된 모든 문자를 대문자로 변경하고 MaxLength 속성을 사용하여 암호 길이를 8자로 제한합니다. 또한 이 예제에서는 TextAlign 속성을 사용하여 암호를 TextBox 컨트롤의 가운데로 정렬합니다.

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;
 }

플랫폼

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

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

TextBox 클래스
TextBox 멤버
System.Windows.Forms 네임스페이스