TextBoxBase.MaxLength Tulajdonság

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

TextBoxBase.cs

Lekéri vagy beállítja a felhasználó által beírható vagy beilleszthető karakterek maximális számát a szövegdoboz vezérlőelembe.

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

Tulajdonság értéke

Int32

A vezérlőelembe beírható karakterek száma. Az alapértelmezett érték 32767.

Kivételek

ArgumentOutOfRangeException

A tulajdonsághoz rendelt érték kisebb, mint 0.

Példák

Az alábbi példakód a származtatott osztályt TextBoxhasználja egy jelszó elfogadásához használt szövegdoboz létrehozásához. Ez a példa a CharacterCasing tulajdonság használatával az összes beírt karaktert nagybetűsre, a MaxLength tulajdonságot pedig nyolc karakterre korlátozza. Ez a példa a TextAlign tulajdonság használatával is középre helyezi a jelszót a TextBox vezérlőben.

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

Megjegyzések

Ezzel a tulajdonságdal korlátozhatja a vezérlőelemben megadott szöveg hosszát az olyan értékek esetében, mint az irányítószámok és a telefonszámok, vagy korlátozhatja a beírt szöveg hosszát, amikor az adatokat be szeretné írni egy adatbázisban. A vezérlőelembe beírt szöveget az adatbázis megfelelő mezőjének maximális hosszára korlátozhatja.

Note

A kódban a tulajdonság értékét Text olyan értékre állíthatja, amelynek hossza nagyobb, mint a MaxLength tulajdonság által megadott érték. Ez a tulajdonság csak a vezérlőbe futtatáskor beírt szöveget érinti.