使用ASP.NET移动控件模板集和模板化控件的步骤

使用ASP.NET移动控件模板集和模板化控件的步骤

ASP.NET 移动控件  

模板集和模板化控件

 

ASP.NET 提供了模板化控件,这种控件公开若干模板属性,开发人员可以应用这些属性来标记语言目标。这些模板在控件呈现期间插入到适当的位置。例如,有用于 List 控件的模板,如页眉和页脚模板。有了这一功能,就可以根据不同的设备,在运行时对控件的外观进行大量的自定义。

ASP.NET 移动控件扩展了此模型,并引入了模板集的概念。模板集是由模板组成的集合。但是,单个模板化控件可能引用多个模板集,而每个模板集都具有不同的特定于设备的条件。

模板集的呈现条件

模板化控件的每个模板集都包含在 <Choice> 元素中,而该元素驻留在共享的 <DeviceSpecific> 元素内。

运行时,按顺序计算 <DeviceSpecific> 元素中的选项。第一个匹配的 <Choice> 元素用于特定于设备的内容。如果选中的选项包含模板,控件将使用这些模板。如果没有找到模板,或者指定的选项都不适用,则控件以默认的呈现方式呈现。

根据设计,不能以编程方式更改当前窗体的 StyleReference 属性,然后立即切换到另一窗体并希望控件以新的样式设置呈现。由于样式模板是在引用 StyleReference 属性之前加载的;因此,编程更改不过是马后炮。

特定于控件的呈现

模板模式中的控件呈现行为是特定于控件的。有些控件(如 List 和 ObjectList)可能从提供的模板呈现它们的所有内容。有些控件则可能将特定模板的内容添加到它们的默认内容中。例如,如果为 Form 控件指定并选择了页眉或页脚模板,则该模板中包含的标记将被添加到窗体内容中,分别作为页眉或页脚。

设置模板化控件的属性

设置模板中的控件属性比设置不在模板中的控件属性稍微费点事。您必须获取对命名容器的引用,并使用 FindControl 方法查找链接控件,然后才可以设置属性。下面的示例简要阐释了这些概念。

[C#]
void Page_Load(Object sender, EventArgs e) {

 // Iterate through the controls in the form.
 foreach(Control c in Form1.Controls)  {

   if(c.GetType().ToString() ==
   "System.Web.UI.MobileControls.TemplateContainer")   {
   // Get the link control.
   Control ctrl = c.FindControl("myLink");

   if (ctrl != null)    {
    // Set the text and url properties.
    ((System.Web.UI.MobileControls.Link)ctrl).Text = "Home Page";
    ((System.Web.UI.MobileControls.Link)ctrl).NavigateURL = 
     "http://www.microsoft.com/china";
   }
  }
 }
}

模板集和样式

StyleSheet 控件中的样式可能还包含模板集。因此可以有多个模板化控件,它们引用同一样式,使用相同的模板集,而且提供与样式所提供的封装相同的优点。有关阐释模板集的示例,请参见 ASP.NET 移动控件快速入门。

样式模板与样式属性的比较

如样式文档中所述,可以从父级继承样式,也可以显式设置 StyleReference 属性,或通过聚合继承样式。但是,使用模板时不存在层叠效果。除非使用样式表中的模板,否则无法从父级样式模板中获得一个模板。

与设备无关的模板

任何模板化控件都可以有与设备无关的模板。要指定与设备无关的模板,请使用不带显式 Filter 属性的 <Choice> 元素。指定与设备无关的选项时,它必须始终是最后声明的选项,以便在没有任何其他选项适用于目标设备时选择它。

窗体控件中的模板用户界面

在一些高级方案中,动态实例化和添加模板很有用。下面的代码示例在 Init 事件处理程序中添加模板。

[C#]
<%@ Page language="c#" Inherits="System.Web.UI.MobileControls.MobilePage" Debug="true"%>
<script runat="server">
private void Form_Init(object sender, System.EventArgs e)
{
  DeviceSpecific devSpecific = new DeviceSpecific();

  // Create the choice tag.
  DeviceSpecificChoice devChoice = new DeviceSpecificChoice();
  devChoice.Filter = "isHTML32";
   
  // Create the template.
  ITemplate myTemplate;
  myTemplate = new CustomTemplate("HeaderTemplate");
  
  // Create the templateContainer.
  TemplateContainer container = new TemplateContainer();
  myTemplate.InstantiateIn(container);
            
  // Create the tree.
  devChoice.Templates.Add("HeaderTemplate", myTemplate);
  ((IParserAccessor)devSpecific).AddParsedSubObject(devChoice);
  ((IParserAccessor)Form1).AddParsedSubObject(devSpecific);
}

public class CustomTemplate : ITemplate
{  
  String strWhichTemplate;

  public CustomTemplate(String strTemplate)
  {
   strWhichTemplate = strTemplate;
  }
  
  public void InstantiateIn(Control container)
  {
   if(strWhichTemplate == "HeaderTemplate")
   {
     System.Web.UI.MobileControls.Label lb = new System.Web.UI.MobileControls.Label();
     lb.Text = "Header Template";

     System.Web.UI.MobileControls.Command cmd = new System.Web.UI.MobileControls.Command();
     cmd.Text = "hello";

     container.Controls.Add(lb);
     container.Controls.Add(cmd);
   }
   else if(strWhichTemplate == "FooterTemplate")
   {
     System.Web.UI.MobileControls.Label lb = new System.Web.UI.MobileControls.Label();
     lb.Text = "FooterTemplate";
     container.Controls.Add(lb);
   }
   
  }
}

</script>
<body>
  <mobile:Form id="Form1" runat="server" OnInit="Form_Init">
  </mobile:Form>
</body>

使用特定于设备的模板时的特殊注意事项

混合使用特定于设备的标记语言与移动控件时,必须基于移动控件呈现的内容来确保一致性。混合使用特定于设备的标记和与设备无关的标记时,不支持智能检测和匹配。

例如,在下面的部分代码示例中,请注意第一个 Panel 控件和 Label 控件的 alignment 设置。

<mobile:Panel runat=server alignment="right">
<DeviceSpecific>
  <Choice Filter="isWML11">
   <ContentTemplate>
     <table columns="2" align="LR">
   <tr><td>
   </ContentTemplate>
  </Choice></Devicespecific>
</mobile:panel>

<Mobile:Label id="label1" runat=server Text="HELLO, HOW ARE YOU?" 
  alignment="left">
</Mobile:Label>
<mobile:Panel runat=server>
  <DeviceSpecific>
   <Choice Filter="isWML11">
     <ContentTemplate></td><td>
     </ContentTemplate>
   </Choice>
  </Devicespecific> 
</mobile:panel>

WML <p> 元素用于呈现非默认的对齐方式。在前面的示例中,由于第二个 Label 控件在 WML <td> 标记内,浏览器错误地呈现为第二个 Label 控件生成的 <p> 标记。

这种情况下,由于 Label 控件不从第一个 Panel 控件继承对齐方式,因此它为自己的对齐方式生成一个 <p> 标记。但是,此情况下不能添加 <p> 标记。这种情况并不常见,通过以下方式可以解决此问题:将 Label 控件标记为仅当目标设备不是基于 WML 的设备时可见,并在模板中指定 Label 控件的文本。

任意特定于设备的标记

有些情况下,可能需要插入用于特定设备或特定设备类型的任意标记。为启用此功能,ASP.NET 移动 Web 窗体为 Panel 控件提供了 ContentTemplate 模板。如果选中的选项包含 ContentTemplate 模板,则控件呈现时使用该模板而不是通常的内容。