使用 Anthem.NET 框架的一个调试经历

简介：Anthem 是一个很好用的 Ajax 框架，支持 ASP.NET 1.1, 2.0。
由于该框架的所有控件都继承自 ASP.NET 自身的服务器控件，保留了几乎所有这些控件的属性和行为（除了把它们的 PostBack 改为 CallBack 的无刷新调用之外）。所以学习曲线很平缓。

今天我在使用 Anthem 的时候碰到了一个比较麻烦的调试问题，记录于此。

在下面的代码中，我用了一个 Anthem.Repeater 控件。

         < asp:XmlDataSource  ID ="XmlDataSource2"  runat ="server"  XPath ="//NeedDocs/Doc"
        EnableCaching ="false" ></ asp:XmlDataSource >
         <table class="mytable" width="100%" cellspacing="0" cellpadding="0">
           < anthem:Repeater  ID ="rptNeedDocs"  runat ="server"  DataSourceID ="XmlDataSource2"
          AutoUpdateAfterCallBack ="False" >
             < HeaderTemplate >
               < tr  class ="formTitle" >
                 < td >
                  选中 </ td >
                 < td >
                  文件、图纸名称 </ td >
                 < td >
                  应送 </ td >
                 < td >
                  是否原件 </ td >
                 < td >
                  备注 </ td >
               </ tr >
             </ HeaderTemplate >
             < ItemTemplate >
               < tr >
                 < td >
                   < asp:CheckBox  ID ="chkDoc"  runat ="server"  Checked ="True"   />
                   < asp:HiddenField  ID ="hidDocId"  runat ="server"  Value ='<%#  XPath("@Id") % > ' />
                 </ td >
                 < td >
                   < asp:Label  ID ="lblDocName"  runat ="server"  Text ='<%#  XPath("@Name") % > ' />
                 </ td >
                 < td >
                   < asp:TextBox  ID ="txtQuantity"  runat ="server"  Text ='<%#  XPath("@Quantity") % > ' Width="30" />
                 </ td >
                 < td >
                   < asp:RadioButtonList  ID ="radiolist_IsOriginal"  runat ="server"  SelectedValue ='<%#  XPath("@IsOriginal") % > '
                    RepeatDirection="Horizontal">
                     < asp:ListItem  Value ="True" > 原件 </ asp:ListItem >
                     < asp:ListItem  Value ="False" > 副本 </ asp:ListItem >
                   </ asp:RadioButtonList >
                 </ td >
                 < td >
                   < asp:TextBox  ID ="txtComment"  runat ="server"  Text ='<%#  XPath("Comment") % > ' />
                 </ td >
               </ tr >
             </ ItemTemplate >
             < FooterTemplate >
             </ FooterTemplate >
           </ anthem:Repeater >
         </table>

这个代码在运行时，有时候会出现一个 JS 错误：“未知的运行时错误”。
而该错误只在特定情况下发生，在其他类似情况下正常。
幸亏 VS 2005 提供了非常强大的客户端脚本调试功能。我终于将错误定位到了 Anthem 产生的一行代码上：

control.innerHTML  =  result.controls[controlID];

查了相关资料后发现，在 IE 下，对 innerHTML 属性赋值的时候，会对所赋的值进行检查。如果不是 well formed, 则可能会出现“未知的运行时错误”。

于是我判断 anthem.Repeater 输出的 HTML 出了问题。从上面代码中高亮的两行可以看到，table 标签在 Repeater 的外面。因此 Repeater 本身输出的是一系列 tr, 并不是 well formed 的一个整体。
于是我将 table 的标签头尾分别放入 Repeater 的 HeaderTemplate 和 FooterTemplate，问题解决。
（之所以先前把 table 标签放到外面去了，是因为放在 HeaderTemplate 和 FooterTemplate 中的时候，不知道为什么 VS 的设计器不能切换到设计视图了。而改成这样可以解决问题。）

修改成功后的代码如下：

         < asp:XmlDataSource  ID ="XmlDataSource2"  runat ="server"  XPath ="//NeedDocs/Doc"
        EnableCaching ="false" ></ asp:XmlDataSource >
         < anthem:Repeater  ID ="rptNeedDocs"  runat ="server"  DataSourceID ="XmlDataSource2"  AutoUpdateAfterCallBack ="False" >
           < HeaderTemplate >
             <table class="mytable" width="100%" cellspacing="0" cellpadding="0">
               < tr  class ="formTitle" >
                 < td >
                  选中 </ td >
                 < td >
                  文件、图纸名称 </ td >
                 < td >
                  应送 </ td >
                 < td >
                  是否原件 </ td >
                 < td >
                  备注 </ td >
               </ tr >
           </ HeaderTemplate >
           < ItemTemplate >
             < tr >
               < td >
                 < asp:CheckBox  ID ="chkDoc"  runat ="server"  Checked ="True"   />
                 < asp:HiddenField  ID ="hidDocId"  runat ="server"  Value ='<%#  XPath("@Id") % > ' />
               </ td >
               < td >
                 < asp:Label  ID ="lblDocName"  runat ="server"  Text ='<%#  XPath("@Name") % > ' />
               </ td >
               < td >
                 < asp:TextBox  ID ="txtQuantity"  runat ="server"  Text ='<%#  XPath("@Quantity") % > ' Width="30" />
               </ td >
               < td >
                 < asp:RadioButtonList  ID ="radiolist_IsOriginal"  runat ="server"  SelectedValue ='<%#  XPath("@IsOriginal") % > '
                  RepeatDirection="Horizontal">
                   < asp:ListItem  Value ="True" > 原件 </ asp:ListItem >
                   < asp:ListItem  Value ="False" > 副本 </ asp:ListItem >
                 </ asp:RadioButtonList >
               </ td >
               < td >
                 < asp:TextBox  ID ="txtComment"  runat ="server"  Text ='<%#  XPath("Comment") % > ' />
               </ td >
             </ tr >
           </ ItemTemplate >
           < FooterTemplate >
             </table>
           </ FooterTemplate >
         </ anthem:Repeater >

经过这次的调试，我觉得 Ajax 除了带来了界面上响应迅速的好处之外，因为引入大量 js，也增大了调试的难度，因此应用的时候还是要根据情况取舍。不能什么都上 Ajax.