TextBoxBase.MaxLength TextBoxBase.MaxLength TextBoxBase.MaxLength TextBoxBase.MaxLength Property

Определение

Возвращает или задает максимальное число символов, которое разрешается вводить или вставлять в элемент управления "текстовое поле".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 ограничивает длину пароля до восьми символов.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.

Применяется к