TextBox.MaxLength Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die maximal zulässige Anzahl von Zeichen im Textfeld ab oder legt diese fest.
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
Eigenschaftswert
Die maximal zulässige Anzahl von Zeichen im Textfeld. Der Standardwert ist 0 (null) und bedeutet, dass die Eigenschaft nicht festgelegt wurde.
- Attribute
Ausnahmen
Der angegebene Wert ist kleiner als 0 (null).
Beispiele
Ein Visual Studio Websiteprojekt mit Quellcode ist verfügbar, um dieses Thema zu begleiten: Download.
Im folgenden Codebeispiel wird veranschaulicht, wie sie das Steuerelement zum Abrufen von TextBox Benutzereingaben verwenden. Wenn der Benutzer auf die Schaltfläche "Hinzufügen " klickt, wird die Summe der in den Textfeldern eingegebenen Werte angezeigt.
Wichtig
Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.
<%@ 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>
Hinweise
Verwenden Sie die MaxLength Eigenschaft, um die Anzahl der Zeichen zu beschränken, die im TextBox Steuerelement eingegeben werden können.
Hinweis
Diese Eigenschaft gilt nur, wenn die TextMode Eigenschaft auf TextBoxMode.SingleLine
oder TextBoxMode.Password
.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.