TextBoxBase.MaxLength Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia maksymalną liczbę znaków, które użytkownik może wpisać lub wkleić do kontrolki pola tekstowego.

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

Wartość właściwości

Int32

Liczba znaków, które można wprowadzić do kontrolki. Wartość domyślna to 32767.

Wyjątki

ArgumentOutOfRangeException

Wartość przypisana do właściwości jest mniejsza niż 0.

Przykłady

Poniższy przykład kodu używa klasy pochodnej , TextBoxdo utworzenia pola tekstowego używanego do akceptowania hasła. W tym przykładzie użyto CharacterCasing właściwości , aby zmienić wszystkie znaki wpisane na wielkie litery i MaxLength właściwość, aby ograniczyć długość hasła do ośmiu znaków. W tym przykładzie TextAlign użyto również właściwości , aby wyśrodkować hasło w kontrolce 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

Uwagi

Za pomocą tej właściwości można ograniczyć długość tekstu wprowadzonego w kontrolce dla wartości, takich jak kody pocztowe i numery telefonów, lub ograniczyć długość tekstu wprowadzonego podczas wprowadzania danych w bazie danych. Tekst wprowadzony w kontrolce można ograniczyć do maksymalnej długości odpowiedniego pola w bazie danych.

Uwaga

W kodzie można ustawić wartość Text właściwości na wartość o długości większej niż wartość określona MaxLength przez właściwość. Ta właściwość wpływa tylko na tekst wprowadzony w kontrolce w czasie wykonywania.