TextBox.MaxLength Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает максимальное разрешенное число знаков в текстовом окне.
public:
virtual property int MaxLength { int get(); void set(int value); };
[System.ComponentModel.Bindable(true)]
public virtual int MaxLength { get; set; }
[System.Web.UI.Themeable(false)]
public virtual int MaxLength { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.MaxLength : int with get, set
[<System.Web.UI.Themeable(false)>]
member this.MaxLength : int with get, set
Public Overridable Property MaxLength As Integer
Значение свойства
Максимальное разрешенное число знаков в текстовом окне. По умолчанию используется значение 0, показывающее, что это свойство не задано.
- Атрибуты
Исключения
Указанная ширина меньше 0.
Примеры
Проект веб-сайта Visual Studio с исходным кодом доступен в следующем разделе: Скачивание.
В следующем примере кода показано, как использовать TextBox элемент управления для получения пользовательских данных. Когда пользователь нажимает кнопку Добавить , отображается сумма значений, введенных в текстовых полях.
Важно!
В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html>
<html>
<head>
<title>TextBox Example</title>
<script runat="server">
protected void AddButton_Click(Object sender, EventArgs e)
{
int Answer;
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);
AnswerMessage.Text = Answer.ToString();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> TextBox Example </h3>
<p>
<asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/>
+
<asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/>
=
<asp:Label ID="AnswerMessage" runat="server"/>
</p>
<p>
<asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/>
</p>
<p>
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br />" Display="Dynamic"
runat="server"/>
<asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br />" Display="Dynamic"
runat="server"/>
<asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1"
Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"
ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
runat="server"/>
<asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2"
Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"
ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
runat="server"/>
</p>
</form>
</body>
</html>
<%@ Page Language="vb" AutoEventWireup="false" %>
<!DOCTYPE html>
<html>
<head>
<title>TextBox Example</title>
<script runat="server">
Protected Sub AddButton_Click(sender As Object, e As EventArgs)
Dim Answer As Integer
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)
AnswerMessage.Text = Answer.ToString()
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> TextBox Example </h3>
<p>
<asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/>
+
<asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/>
=
<asp:Label ID="AnswerMessage" runat="server"/>
</p>
<p>
<asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/>
</p>
<p>
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br />" Display="Dynamic"
runat="server"/>
<asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br />" Display="Dynamic"
runat="server"/>
<asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1"
Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"
ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
runat="server"/>
<asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2"
Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"
ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
runat="server"/>
</p>
</form>
</body>
</html>
Комментарии
Используйте свойство , MaxLength чтобы ограничить количество символов, которые можно ввести в элементе TextBox управления .
Примечание
Это свойство является применимо, только если TextMode свойству TextBoxMode.SingleLine
или TextBoxMode.Password
.
Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.