TextBoxBase.MaxLength Egenskap

Definition

Hämtar eller anger det maximala antalet tecken som användaren kan skriva eller klistra in i textrutekontrollen.

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

Egenskapsvärde

Antalet tecken som kan anges i kontrollen. Standardvärdet är 32767.

Undantag

Värdet som tilldelats egenskapen är mindre än 0.

Exempel

I följande kodexempel används den härledda klassen , TextBoxför att skapa en textruta som används för att acceptera ett lösenord. I det CharacterCasing här exemplet används egenskapen för att ändra alla tecken som skrivs till versaler och MaxLength egenskapen för att begränsa lösenordslängden till åtta tecken. I det här exemplet används TextAlign även egenskapen för att centrera lösenordet i TextBox kontrollen.

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

Kommentarer

Du kan använda den här egenskapen för att begränsa längden på text som anges i kontrollen för värden som postnummer och telefonnummer, eller för att begränsa längden på den text som anges när data ska anges i en databas. Du kan begränsa texten som anges i kontrollen till den maximala längden på motsvarande fält i databasen.

Note

I kod kan du ange värdet för Text egenskapen till ett värde som har en längd som är större än värdet som anges av MaxLength egenskapen. Den här egenskapen påverkar endast text som anges i kontrollen vid körning.

Gäller för