ASP.NET TextBox 控件用于创建用户可输入文本的文本框
属性
| 属性 | 描述 | .NET |
|---|---|---|
| AutoCompleteType | 规定 TextBox 控件的 AutoComplete 行为 | 2.0 |
| AutoPostBack | 布尔值，规定当内容改变时，控件是否自动回传到服务器。默认是 false | 1.0 |
| CausesValidation | 规定当 Postback 发生时，是否验证页面 | 2.0 |
| Columns | textbox 的宽度 | 1.0 |
| MaxLength | 在 textbox 中所允许的最大字符数 | 1.0 |
| ReadOnly | 规定能否改变文本框中的文本 | 1.0 |
| Rows | textbox 的高度（仅在 TextMode="Multiline" 时使用） | 1.0 |
| runat | 规定该控件是否是服务器控件。必须设置为 "server" | |
| TagKey | ||
| Text | textbox 的内容 | 1.0 |
| TextMode | 规定 TextBox 的行为模式（单行、多行或密码） | 1.0 |
| ValidationGroup | 当 Postback 发生时，被验证的控件组 | |
| Wrap | 布尔值，指示 textbox 的内容是否换行 | 1.0 |
| OnTextChanged | 当 textbox 中的文本被更改时，被执行的函数的名称 |
ASP.NET TextBox AutoCompleteType 属性
ASP.NET TextBox AutoCompleteType 属性用于设置或返回 TextBox 控件的 AutoComplete 种类
AutoComplete 特性可创建在文本框中已输入的值列表
当再次使用该文本框时，已输入的值的列表会显示出来
用户可以直接选取值，而不需要重复键入之前已输入的值
语法
<asp:TextBox AutoCompleteType="cat" runat="server" />
| 属性 | 描述 |
|---|---|
| cat | 规定 AutoComplete 种类 可能的值： BusinessCity - 办公地址所在城市类别 BusinessCountryRegion - 办公地址所在国家/地区类别 BusinessFax - 办公地址的传真号码类别 BusinessPhone - 办公地址的电话号码类别 BusinessState - 办公地址所在州类别 BusinessStreetAddress - 办公地址所在街道地址类别 BusinessUrl - 业务网站的 URL 类别 BusinessZipCode - 办公地址的邮政编码类别 Cellular - 移动电话号码类别 Company - 企业名称类别 Department - 企业内的部门类别 Disabled - 为 TextBox 控件禁用自动完成功能 DisplayName - 为该用户显示的名称类别 Email - 用户的电子邮件地址类别 FirstName - 用户名类别 Gender - 用户性别类别 HomeCity - 家庭地址所在城市类别 HomeCountryRegion - 家庭地址所在国家/地区类别 HomeFax - 家庭地址的传真号码类别 Homepage - 网站的 URL 类别 HomePhone - 家庭地址的电话号码类别 HomeState - 家庭地址所在州类别 HomeStreetAddress - 家庭地址所在街道类别 HomeZipCode - 家庭地址的邮政编码类别 JobTitle - 用户的职务类别 LastName - 用户的姓氏类别 MiddleName - 用户的中名类别 None - 无任何类别与 TextBox 控件相关联 具有相同 ID 的所有 TextBox 控件都共享同一值列表 Notes - 要包含在窗体类别中的任何补充信息 Office - 业务办公室所在位置类别 Pager - 寻呼机号码类别 Search - 用于搜索网页或网站的关键字类别 |
范例
下面的范例把 AutoCompleteType 属性设置为 "FirstName"
<form runat="server">
<asp:TextBox id="tb1" runat="server" AutoCompleteType="FirstName" />
</form>ASP.NET TextBox AutoPostBack 属性
ASP.NET TextBox AutoPostBack 属性用于设置或返回当用户在 TextBox 控件中按 "ENTER" 或 "TAB" 键时，是否发生自动回传到服务器的操作
如果把该属性设置为 TRUE，则启用自动回传，否则为 FALSE
默认是 FALSE
语法
<asp:TextBox AutoPostBack="TRUE|FALSE" runat="server" />
范例
下面的范例把 AutoPostBack 属性设置为 "TRUE"
<form runat="server">
<asp:TextBox id="tb1" runat="server" AutoPostBack="TRUE" />
</form>ASP.NET TextBox Columns 属性
ASP.NET TextBox Columns 属性用于设置或返回 TextBox 控件的宽度
语法
<asp:TextBox Columns="num" runat="server" />
| 属性 | 描述 |
|---|---|
| num | 数值，该值规定文本框的宽度，以字符数计 |
范例
下面的范例设置了 TextBox 控件的宽度
<form runat="server">
<asp:TextBox id="tb1" runat="server" Columns="50" />
</form>ASP.NET TextBox MaxLength 属性
ASP.NET TextBox MaxLength 属性用于设置或返回 TextBox 控件中所允许的最大字符数
语法
<asp:TextBox MaxLength=" *num* " runat="server" />
| 属性 | 描述 |
|---|---|
| num | 数值，该值规定了文本框中所允许的最大字符数 |
范例
下面的范例设置了 TextBox 控件中所允许的最大字符数
<form runat="server">
<asp:TextBox id="tb1" runat="server" MaxLength="10" />
</form>ASP.NET TextBox ReadOnly 属性
ASP.NET TextBox ReadOnly 属性用于设置或返回能否更改 TextBox 控件中的文本
如果该属性被设置为 TRUE，则无法更改文本，否则为 FALSE
默认是 FALSE
语法
<asp:TextBox ReadOnly="TRUE|FALSE" runat="server" />
范例
下面的范例把 ReadOnly 属性设置为 "TRUE"
<form runat="server">
<asp:TextBox id="tb1" runat="server" ReadOnly="TRUE"
Text="This text is read only" />
</form>ASP.NET TextBox Rows 属性
ASP.NET TextBox Rows 属性用于设置或返回 TextBox 控件的高度
该属性仅在 TextMode="Multiline" 时使用
语法
<asp:TextBox runat="server" Rows="num" TextMode="MultiLine" />
| 属性 | 描述 |
|---|---|
| num | 数值，该值规定文本框的高度，以行数计 |
范例
下面的范例设置了 TextBox 控件的高度
<form runat="server">
<asp:TextBox id="tb1" runat="server"
TextMode="MultiLine" Rows="5" />
</form>ASP.NET TextBox Text 属性
ASP.NET TextBox Text 属性用于设置或返回 TextBox 控件的文本
语法
<asp:TextBox Text="string" runat="server" />
| 属性 | 描述 |
|---|---|
| string | 字符串值，规定 TextBox 控件的文本 |
范例
下面的范例设置了 TextBox 控件的文本
<form runat="server">
<asp:TextBox id="tb1" runat="server" Text="Name" />
</form>ASP.NET TextBox TextMode 属性
ASP.NET TextBox TextMode 属性用于设置或返回 TextBox 控件的行为模式
语法
<asp:TextBox TextMode="mode" runat="server" />
| 属性 | 描述 |
|---|---|
| mode | TextMode 枚举值之一。默认值为 SingleLine 可能的值： SingleLine - 默认。表示单行输入模式 MultiLine - 表示多行输入模式 Password - 表示密码输入模式 |
范例
下面的范例把 TextBox 控件的文本模式设置为 "Password"
<form runat="server">
<asp:TextBox id="tb1" runat="server" TextMode="Password" />
</form>ASP.NET TextBox Wrap 属性
ASP.NET TextBox Wrap 属性用于设置或返回在多行文本框中文本内容是否换行
该属性仅在 TextMode="Multiline" 时使用
语法
<asp:TextBox Wrap="TRUE|FALSE" TextMode="MultiLine" runat="server" />
范例
下面的范例把 Wrap 属性设置为 "False"
<form runat="server">
<asp:TextBox id="tb1" runat="server"
TextMode="MultiLine" Wrap="False" />
</form>Web 控件标准属性
- AccessKey
- Attributes
- BackColor
- BorderColor
- BorderStyle
- BorderWidth
- CssClass
- Enabled
- Font
- EnableTheming
- ForeColor
- Height
- IsEnabled
- SkinID
- Style
- TabIndex
- ToolTip
- Width
如果想要查看完整描述，请访问我们的 Web 控件标准属性
控件标准属性
- AppRelativeTemplateSourceDirectory
- BindingContainer
- ClientID
- Controls
- EnableTheming
- EnableViewState
- ID
- NamingContainer
- Page
- Parent
- Site
- TemplateControl
- TemplateSourceDirectory
- UniqueID
- Visible
如果你想要查看完整描述，可以访问我们的 控件标准属性
范例
Textbox
<script runat="server">
Sub submit(sender As Object, e As EventArgs)
lbl1.Text="Your name is " & txt1.Text
End Sub
</script>
<!DOCTYPE html>
<meta charset="utf-8" />
<form runat="server">
Enter your name:
<asp:TextBox id="txt1" runat="server" />
<asp:Button OnClick="submit" Text="Submit" runat="server" />
<p><asp:Label id="lbl1" runat="server" /></p>
</form>
范例中，我们在 .aspx 文件中声明了一个 TextBox 控件，一个 Button 控件，和一个 Label 控件当提交按钮被触发时，会执行 submit 子例程这个 submit 子例程会向 Label 控件输出文本
Textbox 2
<script runat="server">
Sub change(sender As Object, e As EventArgs)
lbl1.Text="You changed text to " & txt1.Text
End Sub
</script>
<!DOCTYPE html>
<meta charset="utf-8" />
<form runat="server">
Enter your name:
<asp:TextBox id="txt1" runat="server"
text="Hello World!"
ontextchanged="change" autopostback="true"/>
<p><asp:Label id="lbl1" runat="server" /></p>
</form>
范例中，我们在 .aspx 文件中声明了一个 TextBox 控件，一个 Button 控件，和一个 Label 控件当提交按钮被触发时，会执行 submit 子例程这个 submit 子例程会把文本框的内容拷贝到 Label 控件
