TextBoxBase.MaxLength Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

TextBoxBase.cs

Возвращает или задает максимальное количество символов, которые пользователь может вводить или вставлять в элемент управления текстового поля.

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

Значение свойства

Int32

Число символов, которые можно ввести в элемент управления. Значение по умолчанию — 32767.

Исключения

ArgumentOutOfRangeException

Значение, назначенное свойству, меньше 0.

Примеры

В следующем примере кода используется производный класс, TextBoxчтобы создать текстовое поле, которое используется для принятия пароля. В этом примере свойство используется CharacterCasing для изменения всех символов, введенных в верхний регистр, и MaxLength свойство для ограничения длины пароля до восьми символов. В этом примере также используется 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 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

Комментарии

Это свойство можно использовать для ограничения длины текста, введенного в элемент управления, для значений, таких как почтовые коды и номера телефонов, или ограничить длину текста, введенную при вводе данных в базу данных. Текст, введенный в элемент управления, можно ограничить максимальной длиной соответствующего поля в базе данных.

Замечание

В коде можно задать для свойства значение Text , которое имеет длину, превышающую значение, указанное свойством MaxLength . Это свойство влияет только на текст, введенный в элемент управления во время выполнения.