TextBoxBase.MaxLength Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví maximální počet znaků, které uživatel může zadat nebo vložit do ovládacího prvku textového pole.

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

Hodnota vlastnosti

Int32

Počet znaků, které lze zadat do ovládacího prvku. Výchozí hodnota je 32767.

Výjimky

ArgumentOutOfRangeException

Hodnota přiřazená vlastnosti je menší než 0.

Příklady

Následující příklad kódu používá odvozenou třídu , TextBoxk vytvoření textového pole, které se používá k přijetí hesla. Tento příklad používá CharacterCasing vlastnost ke změně všech znaků zadaných na velká písmena a MaxLength vlastnost k omezení délky hesla na osm znaků. Tento příklad také používá TextAlign vlastnost ke středu hesla v ovládacím TextBox prvku.

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

Poznámky

Tuto vlastnost můžete použít k omezení délky textu zadaného v ovládacím prvku pro hodnoty, jako jsou PSČ a telefonní čísla, nebo omezit délku textu zadaného při zadávání dat do databáze. Text zadaný do ovládacího prvku můžete omezit na maximální délku odpovídajícího pole v databázi.

Poznámka

V kódu můžete nastavit hodnotu Text vlastnosti na hodnotu, která má délku větší než hodnota zadaná MaxLength vlastností. Tato vlastnost má vliv pouze na text zadaný do ovládacího prvku za běhu.