C# Web控件与数据感应之模板循环输出

关于模板循环输出

数据感应也即数据捆绑，是一种动态的，Web控件与数据源之间的交互，模板循环输出 ，是指使用 UI 前端设计的 HTML 模板片断，并结合数据记录进行循环输出的过程，比如，有如下如图输出 ：

如图人员列表是一个循环输出的过程，我们按照图示设计模板，并结合数据查询结果即可，模板代码如下：

<div id="pitemdetail" runat="server" class="query-box" onclick="waittip(this);window.location='answer.aspx?cid={wxmpCid}&pid={cid}'" 
                style="border-radius:5px; cursor:pointer; padding:10px; background-color:White; margin-bottom:10px">
                   <div style="display:flex;flex-direction:row; flex-wrap:wrap;justify-content:space-between; "><label style="cursor:pointer; font-size:12pt; color:Gray; "  >
                   <b>{name}</b></label>{dtip}</div>
                    <div style="width:100%; color:Silver; ">{dname}</div>
                    
                    <div></div>
</div><!-- pitemdetail  -->

<asp:Literal ID="result" runat="server"></asp:Literal>

其中 id 为 pitemdetail 的 div 即为设计模板片断，其设计要点如下：

（1）需要添加 runat="server" 服务器标记

（2）输出的数据，用花括号和字段名表示，如代码中的 "{wxmpCid}","{name}" 。字段名可以用DataSet.Tables.Colums 里的序号进行表示，如 “{0}”，“{1}” ，用序号表示，性能会略有提升，但从代码易读性来讲相对较差。

（3）不可在模板中放置其它服务器控件

id 为 result 的 Literal 控件（用于显示最原始状态静态文本的输出控件），隶属于Microsoft.Web.UI.WebControls 集合，该控件用于存储并显示最后的输出结果。

本文将介绍如何中通过 C# 实现操作 HTML 模板的循环输出。

准备数据源

我们在 MS SQL Server 创建 CCVC_PriceList（支付卡等级表），其结构如下表：
序号字段名类型说明1[PName]nvarchar产品名称2[CCVC][int]初始积分3[Price][money]产品价格4[LogoUrl]nvarchar产品Logo
执行如下 创建表的 SQL 语句：

CREATE TABLE [dbo].[CCVC_PriceList](
    [PName] [nvarchar](50) NOT NULL,
    [CCVC] [int] NOT NULL,
    [Price] [money] NOT NULL,
    [LogoUrl] [nvarchar](500) NULL,
) 
GO

执行如下SQL语句，创建一些数据：

insert into CCVC_PriceList(PName,CCVC,Price,LogoUrl]) values('礼遇卡',24000,1900.00,'v1.jpg');
insert into CCVC_PriceList(PName,CCVC,Price,LogoUrl]) values('金卡',56000,6900.00,'v2.jpg');
insert into CCVC_PriceList(PName,CCVC,Price,LogoUrl]) values('白金卡',120000,15900.00,'v3.jpg');
insert into CCVC_PriceList(PName,CCVC,Price,LogoUrl]) values('钻石卡',210000,18900.00,'v4.jpg');
insert into CCVC_PriceList(PName,CCVC,Price,LogoUrl]) values('至尊卡',1000000,78900.00,'v5.jpg');

通过查询分析器，执行查询SQL语句，显示如下图：

​

最后我们将数据填充到 DataReader ,并生成对应的二维数组。

范例运行环境

操作系统： Windows Server 2019 DataCenter

数据库：Microsoft SQL Server 2016

.net版本： .netFramework4.0 或以上

开发工具：VS2019 C#

RepeatHtml 方法

设计与实现

RepeatHtml 方法主要是通过 object[,] 二维对象数组数据源进行提取并根据模板 HTML 循环输出到指定的接收控件上，其参数设置见下表：
序号参数名类型说明1Htmlstring要输出的 HtmlTable 对象
GetReaderData 方法可以访问数据库数据表进行查询结果的提取，并转化为 object[,] 二维数组，具体实现请参考我的文章：《C# Web控件与数据感应之 填充 HtmlTable》中的GetReaderData 方法实现代码。

RepeatHtml 方法实现代码如下：

ArrayList paras=new ArrayList();
string refSql="";
bool HasTitle=false;
System.Data.CommandType ct=System.Data.CommandType.Text;

public string RepeatHtml(string Html)
{
                string rv = "";
                object[,] ReaderData = GetReaderData("SqlServer","您的连接串",refSql,paras,hastitle,ct);
                if (ReaderData == null) return "";
                if (HasTitle == true)
                {
                    for (int k = 0; k < ReaderData.GetLength(1); k++) //列
                    {
                        string fieldname = ReaderData[0,k].ToString();
                        Html = Html.Replace("{" + fieldname + "}", "{" + k.ToString() + "}");
                    }
                }
                for (int i = (HasTitle == true ? 1 : 0); i < ReaderData.GetLength(0); i++) //行
                {
                    object[] repl = new object[ReaderData.GetLength(1)];
                    for (int j = 0; j < ReaderData.GetLength(1); j++) //列
                    {
                        repl[j] = ReaderData[i, j].ToString() ;
                    }
                    rv+=string.Format(Html, repl);
                }
                return rv;
}//RepeatHtml

如何获取模板内容

获取服务器控件的内容元素可划分为两个范围，类似 JavaScript 里的 innerHTML（获取 HTML 元素内部的内容，即元素的子节点，不包括元素本身的标签）和 outerHTML（除了包含 innerHTML 的全部内容外，还包含对象标签本身，用于获取 HTML 元素及其包含的内容的完整HTML表示，包括元素本身在内），下面我们将逐一实现这两种服务器方法：

getOuterHtml 方法

getOuterHtml 通过传递服务器控件参数，获取服务器控件完整的HTML元素内容，代码如下：

public string  getOuterHtml(Control ctl){
                System.Text.StringBuilder strb = new System.Text.StringBuilder();
                System.IO.StringWriter sw = new System.IO.StringWriter(strb);
                System.Web.UI.HtmlTextWriter htw = new HtmlTextWriter(sw);
                ctl.RenderControl(htw);
                string str = strb.ToString();
                return str;
}

getInnerHtml 方法

getInnerHtml 基于 getOuterHtml 方法，获取服务器控件内部元素的所有内容，传递参数用法相同，实现代码如下：

public string getInnerHtml(Control ctl)
{
                string str = "";
                for (int j = 0; j < ctl.Controls.Count; j++)
                {
                    str += getOuterHtml(ctl.Controls[j]);
                }
                return str;
}

调用示例

客户端模板设计代码如下：

<div id="pitemdetail" runat="server" style=" width:270px; border-radius:10px; cursor:pointer; padding:10px; background-color:WhiteSmoke; margin-bottom:10px">
     <div style="display:flex;flex-direction:row; flex-wrap:wrap;justify-content:space-between; ">
     <img src="{LogoUrl}" width="125" height="75" /><div><span style="font-size:14pt;">{PName}</span><div style="width:100%; color:Gray;font-size:9pt "><br>售价：{Price}元<br>赠积分：{CCVC}</div></div></div>
</div><!-- pitemdetail  -->

<asp:Literal ID="result" runat="server"></asp:Literal>

服务端示例代码如下：

string refSql="SELECT [PName],[CCVC],[Price], LogoUrl FROM [CCVC_PriceList]  order by CCVC";
bool HasTitle=false;
System.Data.CommandType ct=System.Data.CommandType.Text;

        pitemdetail.Visible = true;
        string itemmodule = getOuterHtml(pitemdetail);
        result.Text = RepeatHtml(itemmodule);
        pitemdetail.Visible = false;

提示：pitemdetail 模板块，需要在调用前显示，调用后隐藏。

调用成功显示效果如下图所示：

小结

RepeatHtml 方法一般配合 getOuterHtml 方法使用，如果运行出现服务器字符串格式错误，请检查花括号输出的字段是否存在以及大小写情况，尽量与SQL语句输出保持一致。以上就是关于模板循环输出的介绍，我们可以根据自己的实际需要进行改造，本示例代码仅供您参考。

感谢您的阅读，希望本文能够对您有所帮助。