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 Control

Sub 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 Control

void 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

请参见

参考

其他资源