[Wap]Command 控件

Command 控件提供了一种从用户界面元素调用 ASP.NET 事件处理程序的方法，从而可以将用户输入从用户界面元素回发到服务器。Command 控件实现 IPostBackDataHandler 接口，因此它可以处理通过单击图像创建的回发事件。

移动控件语法
必需的属性、默认值和具有代码特征的元素以粗体显示。

<mobile:Command
   runat="server"
   id="id"
   Font-Name="fontName"
   Font-Size="{NotSet|Normal|Small|Large}"
   Font-Bold="{NotSet|False|True}"
   Font-Italic="{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   Alignment="{NotSet|Left|Center|Right}"
   BreakAfter="{True|False}"
   EnableViewState="{True|False}"
   StyleReference="styleReference"
   Text="text"
   Visible="{True|False}"
   Wrapping="{NotSet|Wrap|NoWrap}"

   CausesValidation="{NotSet|False|True}"
   CommandArgument="commandArgument"
   CommandName="commandName"
   Format="Button|Link"
   ImageUrl="imageUrl"
   OnClick="clickEventHandler"
   OnItemCommand="commandEventHandler"
   SoftkeyLabel="softkeyLabel">
innerText
</mobile:Command>
包容规则
以下控件可以包含 Command 控件。

控件 说明
System.Web.UI.MobileControls.Form 可以包含任意多个 Command 控件。
System.Web.UI.MobileControls.Panel 可以包含任意多个 Command 控件。

文本控件不能包含任何其他控件。

设备模板
无。

特定于设备的行为
呈现命令的样式将根据设备的不同有所不同，但命令的文本将显示在所有设备上。您可以从所有设备调用 Command 控件。

设备语言 行为描述
HTML Command 控件作为按钮呈现为一个 <input> 标记，后接一个 <br/> 标记
如果同一个窗体上有多个命令并发生一个提交操作，则第一个命令将接收 Click 事件。但是，在某些 HTML 窗体上，ENTER 键无效。如果在具有 Command 控件的页上按 ENTER 键，则第一个命令将接收 Click 事件。
 
WML Command 控件以下面的格式生成 WML。
<anchor>TextProperty<go href="postbackinfo"/> </go></anchor>
<br/>
注意   您必须避免在 ASP.NET 移动 Web 窗体页 URL 中使用特殊字符。为将命令事件回发到服务器而生成的 HREF 标记未经严格验证。包含空格的 URL 导致所生成的 WML 不能被某些 WML 浏览器处理。
在某些情况下（例如窗体提交），Command 控件以 <do> 元素而不是定位点的形式呈现给 WML。在这些情况下，将忽略 FontSize、FontStyle 和 Wrapping 属性。
 

示例
下面的示例使用两个标签，每个窗体上使用一个。第一个标签未进行修改，因此不需要 ID 值。第二个标签的 ID 值是 WelcomeMessage，在 Button_OnClick 事件处理程序中设置其文本值。

[Visual Basic]
< %@ Page  Inherits =
    " System.Web.UI.MobileControls.MobilePage "  Language = " VB "  % >
< %@ Register TagPrefix = " mobile "
     Namespace = Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="vb" runat="server">
protected Sub Button_OnClick()Sub Button_OnClick(sender As Object, e As EventArgs) 
   WelcomeMessage.Text = "Welcome to my app, " + NameEdit.Text
   ActiveForm = SecondPanel
End Sub
</script>

<mobile:Form runat="server">
   <mobile:Label runat="server">Enter your name</mobile:Label>
   <mobile:TextBox runat="server" id="NameEdit" />
   <mobile:Command runat="server" id="Button" OnClick="Button_OnClick">
      OK
   </mobile:Command>
</mobile:Form>

<mobile:Form runat="server" id="SecondPanel">
   <mobile:Label runat="server" id="WelcomeMessage" />
</mobile:Form> 

 

 

[C#]
<% @ Page Inherits =
    " System.Web.UI.MobileControls.MobilePage "  Language = " C# "   %>
<% @ Register TagPrefix = " mobile "
    Namespace = " System.Web.UI.MobileControls "
    Assembly = " System.Web.Mobile "   %>

< script language = " c# "  runat = " server " >
protected   void  Button_OnClick(Object sender, EventArgs e) 
... {
   WelcomeMessage.Text = "Welcome to my app, " + NameEdit.Text;
   ActiveForm = SecondPanel;
}
</ script >

< mobile:Form runat = " server " >
    < mobile:Label runat = " server " > Enter your name </ mobile:Label >
    < mobile:TextBox runat = " server "  id = " NameEdit "   />
    < mobile:Command runat = " server "  id = " Button "  OnClick = " Button_OnClick " >
      OK
    </ mobile:Command >
</ mobile:Form >

< mobile:Form runat = " server "  id = " SecondPanel " >
    < mobile:Label runat = " server "  id = " WelcomeMessage "   />
</ mobile:Form >