HtmlForm 服务器控件声明性语法
08/20/2007
本文内容
创建一个服务器端控件,该控件映射到
HTML 元素并允许您为网页中的元素创建一个容器。DefaultButton="string"
DefaultFocus="string"
EnableViewState="False|True"
Id="string"
SubmitDisabledControls="False|True"
Visible="True|False"
OnDataBinding="OnDataBinding event handler"
OnDisposed="OnDisposed event handler"
OnInit="OnInit event handler"
OnLoad="OnLoad event handler"
OnPreRender="OnPreRender event handler"
OnUnload="OnUnload event handler"
runat="server"
>
备注
使用 HtmlForm 控件可以对 HTML
元素进行编程。若要利用回发服务,则所有 Web 窗体控件(无论 HTML 控件、Web 控件、用户控件还是自定义控件)都必须嵌套在 HtmlForm 控件的格式良好的开始标记和结束标记之间。如果没有正确结束标记,ASP.NET 将无法识别该元素。该元素将被忽略或者将发生编译错误,具体取决于该元素的构成方式。注意
不能在单个 Web 窗体页上包含多个 HtmlForm 控件。
默认情况下,HtmlForm 控件的 method 属性设置为 POST。您可以根据需要自定义 method 属性,但如果将 method 属性设置为 GET 或 POST 以外的其他值,则可能破坏内置视图状态和 ASP.NET 提供的回发服务。
注意
action 属性始终设置为页本身的 URL。无法更改 action 属性;因此,只能回发到页本身。
示例
下面的示例显示三个 HtmlButton 控件,其中每个按钮都有一个单独的 OnServerClick 事件处理程序。这些事件中的每个事件都导致向服务器回发(在发生回发的所有方案中都需要 HtmlForm 控件)。此例还说明在一个 Web 窗体页上只允许有一个 HtmlForm 控件(包括支持多个事件的窗体)。如果包含多个 HtmlForm 控件,.NET Framework 将引发异常。
HtmlForm ControlSub Button1_OnClick(Source As Object, e As EventArgs)
Span1.InnerHtml = "You clicked Button1"
End Sub
Sub Button2_OnClick(Source As Object, e As EventArgs)
Span2.InnerHtml = "You clicked Button2"
End Sub
Sub Button3_OnClick(Source As Object, e As EventArgs)
Span3.InnerHtml = "You clicked Button3"
End Sub
HtmlForm Sample
OnServerClick="Button1_OnClick">
Button1
OnServerClick="Button2_OnClick">
Button2
OnServerClick="Button3_OnClick">
Button3
HtmlForm Controlvoid Button1_OnClick(object Source, EventArgs e)
{
Span1.InnerHtml="You clicked Button1";
}
void Button2_OnClick(object Source, EventArgs e)
{
Span2.InnerHtml="You clicked Button2";
}
void Button3_OnClick(object Source, EventArgs e)
{
Span3.InnerHtml="You clicked Button3";
}
HtmlForm Sample
OnServerClick="Button1_OnClick">
Button1
OnServerClick="Button2_OnClick">
Button2
OnServerClick="Button3_OnClick">
Button3
请参见
参考
其他资源