TextBoxBase.MaxLength Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.