HtmlInputText 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
允许对服务器上的 HTML <input type= text> 和 <input type= password> 元素进行编程访问。
public ref class HtmlInputText : System::Web::UI::HtmlControls::HtmlInputControl, System::Web::UI::IPostBackDataHandler[System.Web.UI.ValidationProperty("Value")]
public class HtmlInputText : System.Web.UI.HtmlControls.HtmlInputControl, System.Web.UI.IPostBackDataHandler[<System.Web.UI.ValidationProperty("Value")>]
type HtmlInputText = class
inherit HtmlInputControl
interface IPostBackDataHandlerPublic Class HtmlInputText
Inherits HtmlInputControl
Implements IPostBackDataHandler- 继承
- 派生
- 属性
- 实现
示例
下面的代码示例演示如何使用 HtmlInputText 控件获取用户输入。
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void AddButton_Click(Object sender, EventArgs e)
{
int Answer;
Answer = Convert.ToInt32(Value1.Value) +
Convert.ToInt32(Value2.Value);
AnswerMessage.InnerHtml = Answer.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlInputText Example </title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3> HtmlInputText Example </h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes. <br />
Click the Add button to add the two values. <br />
Click the Reset button to reset the text boxes.
</td>
</tr>
<tr>
<td colspan="5">
</td>
</tr>
<tr align="center">
<td>
<input id="Value1"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server"/>
</td>
<td>
+
</td>
<td>
<input id="Value2"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server"/>
</td>
<td>
=
</td>
<td>
<span id="AnswerMessage"
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value1MinCompareValidator"
ControlToValidate="Value1"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value1MaxCompareValidator"
ControlToValidate="Value1"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server"/>
</td>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value2RequiredValidator"
ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value2MinCompareValidator"
ControlToValidate="Value2"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value2MaxCompareValidator"
ControlToValidate="Value2"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server"/>
</td>
<td>
</td>
</tr>
<tr align="center">
<td colspan="4">
<input type="Submit"
name="AddButton"
value="Add"
onserverclick="AddButton_Click"
runat="server"/>
<input type="Reset"
name="AddButton"
value="Reset"
runat="server"/>
</td>
<td>
</td>
</tr>
</table>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub AddButton_Click(sender As Object, e As EventArgs)
Dim Answer As Integer
Answer = Convert.ToInt32(Value1.Value) + Convert.ToInt32(Value2.Value)
AnswerMessage.InnerHtml = Answer.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlInputText Example </title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3> HtmlInputText Example </h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes. <br />
Click the Add button to add the two values. <br />
Click the Reset button to reset the text boxes.
</td>
</tr>
<tr>
<td colspan="5">
</td>
</tr>
<tr align="center">
<td>
<input id="Value1"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server"/>
</td>
<td>
+
</td>
<td>
<input id="Value2"
type="Text"
size="2"
maxlength="3"
value="1"
runat="server"/>
</td>
<td>
=
</td>
<td>
<span id="AnswerMessage"
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value1MinCompareValidator"
ControlToValidate="Value1"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value1MaxCompareValidator"
ControlToValidate="Value1"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server"/>
</td>
<td colspan="2">
<asp:RequiredFieldValidator
ID="Value2RequiredValidator"
ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value2MinCompareValidator"
ControlToValidate="Value2"
Operator="LessThan"
Type="Integer"
ValueToCompare="100"
ErrorMessage="Please enter an integer less than 100.<br />"
Display="Dynamic"
runat="server"/>
<asp:CompareValidator
ID="Value2MaxCompareValidator"
ControlToValidate="Value2"
Operator="GreaterThan"
Type="Integer"
ValueToCompare="0"
ErrorMessage="Please enter an integer greater than 0.<br />"
Display="Dynamic"
runat="server"/>
</td>
<td>
</td>
</tr>
<tr align="center">
<td colspan="4">
<input type="Submit"
name="AddButton"
value="Add"
onserverclick="AddButton_Click"
runat="server"/>
<input type="Reset"
name="AddButton"
value="Reset"
runat="server"/>
</td>
<td>
</td>
</tr>
</table>
</div>
</form>
</body>
</html>
注解
HtmlInputText使用 控件创建允许用户输入文本或密码的单行文本框。 属性 MaxLength 指定可在文本框中输入的最大字符数。 属性 Size 允许您指定文本框的宽度。 若要确定用户在文本框中输入的值，请使用 Value 属性。 控件 HtmlInputText 提供一个 ServerChange 事件，当 属性更改到服务器的帖子之间的值时 Value ，将引发该事件。 这使你可以创建一个事件处理程序，该处理程序在每次引发事件时执行一组自定义指令。
注意
控件 HtmlInputText 不提供回发到服务器的内置方式。 您必须在网页上提供另一个支持发布到服务器的控件（例如 HtmlButton 控件），才能将控件的值发送回服务器。
若要创建多行文本框，请使用 HtmlTextArea 控件。
有关 实例 HtmlInputText的初始属性值的列表， HtmlInputText 请参阅 构造函数。
构造函数
| HtmlInputText() |
使用默认值初始化 HtmlInputText 类的新实例。 |
| HtmlInputText(String) |
使用指定的输入控件类型初始化 HtmlInputText 类的新实例。 |
属性
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取在 ASP.NET 页内的服务器控件标记上表示的所有特性名称和值对的集合。 (继承自 HtmlControl) |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| Controls |
获取 ControlCollection 对象，该对象表示 UI 层次结构中的指定服务器控件的子控件。 (继承自 Control) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| Disabled |
获取或设置一个值，该值指示 HTML 服务器控件是否被禁用。 (继承自 HtmlControl) |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 Control) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| MaxLength |
获取或设置可以在文本框中输入的最大字符数。 |
| Name |
获取或设置 HtmlInputControl 控件的唯一标识符名。 (继承自 HtmlInputControl) |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| Size |
获取或设置文本框的宽度。 |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 Control) |
| Style |
获取应用于 ASP.NET 文件中指定的 HTML 服务器控件的所有级联样式表 (CSS) 属性的集合。 (继承自 HtmlControl) |
| TagName |
获取包含 |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| Type |
获取 HtmlInputControl 的类型。 (继承自 HtmlInputControl) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| Value |
获取或设置文本框的内容。 |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 HtmlControl 视图状态是否区分大小写。 (继承自 HtmlControl) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
方法
事件
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| Disposed |
当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
| Init |
当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
| PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
| ServerChange |
在服务器上更改 Value 属性时发生。 |
| Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
