The TextBox control can be used for both user input and read-only text display. It can be configured to be any one of the following: single-line, multiline, or to accept passwords. If multiline, it automatically wraps, unless the Wrap property is set to false. The text it contains can exceed the length of the control displayed on the page. Table 5-2 lists many of the common properties specific to the TextBox control. If any of these attributes are omitted from the control, then the default value will apply. Table 5-2. Some properties specific to the TextBox control Name | Type | Get | Set | Values | Description |
---|
AutoPostBack | Boolean | x | x | true, false | Determines if automatic postback to server will occur if user changes contents of control. If false, postback to server will not occur until the page is posted, either by a button or another control with AutoPostBack set to true. Default is false. | Columns | Int32 | x | x | 0, 1, 2, and so on | Width of the text box in characters. Default is 0. | MaxLength | Int32 | x | x | 0, 1, 2, and so on | Maximum number of characters allowed. If MaxLength is greater than Columns, then only a portion of the string will display without using the home, end, or arrow keys. Its default value is 0, which does not impose a limit on the number of characters entered into the text box. | ReadOnly | Boolean | x | x | true, false | If true, content cannot be changed by user. Default is false, meaning content can still be changed programmatically. | Rows | Int32 | x | x | 0, 1, 2, and so on | Number of lines of text in a multiline text box. The default is 0, which imposes no limit on the number of lines. | Text | String | x | x | | Content of the TextBox. | TextMode | TextBoxMode | x | x | SingleLine, MultiLine, Password | SingleLine, the default value, displays a single line of text. MultiLine allows multiple lines of text and displays a vertical scroll bar, even for Rows = 1. The text wraps automatically to fit the width of the box. The Enter key enters a CR/LF. The mouse or tab key causes focus to leave the box and initiates postback if AutoPostBack is true. Password displays content in asterisks, then clears the text box on posting. The value is not case-sensitive. | Wrap | Boolean | x | x | true, false | Indicates if text within a multiline text box should wrap. If false, then the text box will have a horizontal scrollbar. Default is true. | The TextBox control raises the TextChanged event, which is handled by the OnTextChanged event handler. This event handler is passed a standard EventArgs argument. |