TextBox.TextMode Property
Gets or sets the behavior mode (single-line, multiline, or password) of the TextBox control.
[Visual Basic] Public Overridable Property TextMode As TextBoxMode [C#] public virtual TextBoxMode TextMode {get; set;} [C++] public: __property virtual TextBoxMode get_TextMode(); public: __property virtual void set_TextMode(TextBoxMode); [JScript] public function get TextMode() : TextBoxMode; public function set TextMode(TextBoxMode);
Property Value
One of the TextBoxMode enumeration values. The default value is SingleLine.
Exceptions
| Exception Type | Condition |
|---|---|
| ArgumentException | The specified text box mode is not one of the TextBoxMode enumeration values. |
Remarks
Use the TextMode property to specify whether TextBox control is displayed as a single-line, multiline, or password text box.
When the TextBox control is in multiline mode, you can control the number of rows displayed by setting the Rows property. You can also specify whether the text should wrap by setting the Wrap property.
If the TextBox control is in password mode, all characters entered into the control are masked.
Example
[Visual Basic, C#] The following example demonstrates how to use the TextMode property to specify a multiline text box.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Protected Sub SubmitButton_Click(sender As Object, e As EventArgs ) Message.Text = "Thank you for your comment: <br>" + Comment.Text End Sub Protected Sub Check_Change(sender As Object, e As EventArgs ) Comment.Wrap = WrapCheckBox.Checked Comment.ReadOnly = ReadOnlyCheckBox.Checked End Sub </script> </head> <body> <form runat="server"> <h3> MultiLine TextBox Example </h3> Please enter a comment and click the submit button. <br><br> <asp:TextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server"/> <br> <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment" ErrorMessage="Please enter a comment.<br>" Display="Dynamic" runat="server"/> <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True" OnCheckedChanged="Check_Change" runat="server"/> <asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True" OnCheckedChanged="Check_Change" runat="server"/> <asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server"/> <hr> <asp:Label ID="Message" runat="server"/> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> protected void SubmitButton_Click(Object sender, EventArgs e) { Message.Text = "Thank you for your comment: <br>" + Comment.Text; } protected void Check_Change(Object sender, EventArgs e) { Comment.Wrap = WrapCheckBox.Checked; Comment.ReadOnly = ReadOnlyCheckBox.Checked; } </script> </head> <body> <form runat="server"> <h3> MultiLine TextBox Example </h3> Please enter a comment and click the submit button. <br><br> <asp:TextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server"/> <br> <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment" ErrorMessage="Please enter a comment.<br>" Display="Dynamic" runat="server"/> <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True" OnCheckedChanged="Check_Change" runat="server"/> <asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True" OnCheckedChanged="Check_Change" runat="server"/> <asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server"/> <hr> <asp:Label ID="Message" runat="server"/> </form> </body> </html>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
TextBox Class | TextBox Members | System.Web.UI.WebControls Namespace | TextBoxMode | Rows | Wrap