TextBoxBase.MaxLength 속성

정의

TextBox 컨트롤에 입력하거나 붙여넣을 수 있는 최대 문자 수를 가져오거나 설정합니다.Gets or sets the maximum number of characters the user can type or paste into the text box control.

public:
 virtual property int MaxLength { int get(); void set(int value); };
public virtual int MaxLength { get; set; }
member this.MaxLength : int with get, set
Public Overridable Property MaxLength As Integer

속성 값

컨트롤에 입력할 수 있는 문자 수입니다.The number of characters that can be entered into the control. 기본값은 32767입니다.The default is 32767.

예외

속성에 할당된 값이 0보다 작은 경우The value assigned to the property is less than 0.

예제

다음 코드 예제에서는 파생된 클래스인 TextBox, 암호를 적용 하는 데 사용 되는 텍스트 상자를 만듭니다.The following code example uses the derived class, TextBox, to create a text box that is used to accept a password. 이 예제에서는 합니다 CharacterCasing 대문자로 입력 한 모든 문자를 변경 하는 속성 및 MaxLength 암호는 길이가 8 자로 제한 하는 속성입니다.This example uses the CharacterCasing property to change all characters typed to uppercase 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 uppercase.
      textBox1->CharacterCasing = CharacterCasing::Upper;
      // 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 uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper;
    // 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 uppercase.
    textBox1.CharacterCasing = CharacterCasing.Upper
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub

설명

우편 번호 및 전화 번호와 같은 값에 대 한 컨트롤에 입력 된 텍스트의 길이를 제한 하거나 데이터를 데이터베이스에 입력 해야 할 때 입력 한 텍스트의 길이 제한 하려면이 속성을 사용할 수 있습니다.You can use this property to restrict the length of text entered in the control for values such as postal codes and telephone numbers, or to restrict the length of text entered when the data is to be entered in a database. 데이터베이스의 해당 필드의 최대 길이를 컨트롤에 입력 한 텍스트를 제한할 수 있습니다.You can limit the text entered into the control to the maximum length of the corresponding field in the database.

참고

코드에서 값을 설정할 수 있습니다 합니다 Text 길이가 지정 된 값 보다 큰 값으로 속성을 MaxLength 속성입니다.In code, you can set the value of the Text property to a value that has a length greater than the value specified by the MaxLength property. 이 속성은 런타임 시 컨트롤에 입력 한 텍스트를만 영향을 줍니다.This property only affects text entered into the control at run time.

적용 대상