TextBoxBase.MaxLength 属性
获取或设置用户可在文本框控件中键入或粘贴的最大字符数。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）
语法
声明
<LocalizableAttribute(True)> _
Public Overridable Property MaxLength As Integer
用法
Dim instance As TextBoxBase
Dim value As Integer
value = instance.MaxLength
instance.MaxLength = value
[LocalizableAttribute(true)]
public virtual int MaxLength { get; set; }
[LocalizableAttribute(true)]
public:
virtual property int MaxLength {
int get ();
void set (int value);
}
/** @property */
public int get_MaxLength ()
/** @property */
public void set_MaxLength (int value)
public function get MaxLength () : int
public function set MaxLength (value : int)
属性值
可以在文本框控件中输入的字符数。默认值为 32767。
异常
| 异常类型 | 条件 |
|---|---|
分配给属性的值小于零。 |
备注
可以使用该属性来限制控件中对于诸如邮政编码和电话号码之类的值所输入的文本的长度，也可以用来限制要在数据库中输入数据时所输入的文本的长度。可以将输入到控件中的文本限制在数据库中相应字段的最大长度范围内。
提示
在代码中，可以将 Text 属性的值设置为长度大于 MaxLength 属性所指定的值的值。该属性只会影响在运行时输入到此控件中的文本。
Windows NT 4.0, Windows 2000, Windows 2000 专业版, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition、Windows XP Professional x64 Edition、Windows Server 2003 平台说明： 对于单行文本框控件，若将 MaxLength 属性设置为 0，则用户能输入的最大字符数为 2147483646 或一个基于可用内存的数目，两数之间选取较小者。对于多行文本框控件，用户能输入的最大字符数为 4294967295 或一个基于可用内存的数目，两数之间选取较小者。
Windows Millennium Edition 平台说明： 对于单行文本框控件，若将 MaxLength 属性设置为 0，则用户能输入的最大字符数为 32,766 或一个基于可用内存的数目，两数之间选取较小者。对于多行文本框控件，用户能输入的最大字符数为 65,535 或一个基于可用内存的数目，两数之间选取较小者。
示例
下面的代码示例使用派生类 TextBox 创建用于接受密码的文本框。此示例使用 CharacterCasing 属性将键入的所有字符更改为大写字符，并使用 MaxLength 属性将密码长度限制为八个字符。此示例还使用 TextAlign 属性使密码在 TextBox 控件中居中显示。
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
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:
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.set_MaxLength(8);
// Assign the asterisk to be the password character.
textBox1.set_PasswordChar('*');
// Change all text entered to be uppercase.
textBox1.set_CharacterCasing(CharacterCasing.Upper);
// Align the text in the center of the TextBox control.
textBox1.set_TextAlign(HorizontalAlignment.Center);
} //CreateMyPasswordTextBox
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0