TextBox::MaxLength Property
Gets or sets the maximum number of characters allowed in the text box.
Assembly: System.Web (in System.Web.dll)
[ThemeableAttribute(false)] public: virtual property int MaxLength { int get (); void set (int value); }
<asp:TextBox MaxLength="Int32" />
Property Value
Type: System::Int32The maximum number of characters allowed in the text box. The default is 0, which indicates that the property is not set.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The specified width is less than 0. |
Use the MaxLength property to limit the number of characters that can be entered in the TextBox control.
Note |
|---|
This property is applicable only when the TextMode property is set to TextBoxMode.SingleLine or TextBoxMode.Password. |
This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and ASP.NET Themes and Skins.
| Topic | Location |
|---|---|
| How to: Set ASP.NET Web Server Control Properties | Building ASP .NET Web Applications |
| How to: Set ASP.NET Web Server Control Properties | Building ASP .NET Web Applications |
The following code example demonstrates how to use the MaxLength property to limit the number of characters allowed in the TextBox control to 3.
Security Note |
|---|
This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview. |
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Note