C# Web控件与数据感应之属性统一设置

关于属性统一设置

准备数据源

范例运行环境

AttributeInducingFieldName 方法

设计与实现

如何根据 ID 查找控件

FindControlEx 方法

调用示例

小结

关于属性统一设置

数据感应也即数据捆绑，是一种动态的，Web控件与数据源之间的交互，属性统一设置，是指业务规则，通过配置数据，统一对数据控件的属性进行赋值，以达到灵活应用的目的。比如是否为必填写项的设置，以便于统一操作。

如图其中放置了一些标签（Label）控件、（TextBox）文本框控件、（DropDownList）下拉列表框，用于录入及选择一些值，比如现工作单位、参加工作时间、职称、职务等信息。

实际业务中，如不同的用户类型，相同的注册界面，则可考虑某些输入项的必填写属性的变化，如没有工作单位的则无须填写现工作单位和参加工作时间，反之在职人员则必须填写（图中标签带有*号的均为必填写项的提示性标志）。根据统一属性设置，可以显示如下图：

图中的现工作单位和参加工作时间前面的*号不存了，则表示为不必填写项，以避免输入“无” 字来“绕” 过检查。

准备数据源

我们在 MS SQL Server 创建表 cfg_ypz（配置数据视图），其结构如下表：

序号	字段名	类型	说明
1	fname	nvarchar	控件主名（如字段名）
2	cname	nvarchar	属性值

我们假设界面有如下控件，代码如下：

<div ><asp:Label id="l_xgzdw"  runat="server"></asp:Label><asp:TextBox id="x_xgzdw" checkSchema="maxlen50"   runat="server"  /><asp:Label id="l_cjgzsj" runat="server"></asp:Label><asp:TextBox id="x_cjgzsj" checkSchema="maxlen50" runat="server"  />
</div>

其中，xgzdw （现工作单位）和 cjgzsj （参加工作时间）即为控件主名，而 l_ 前缀为标签提示控件，x_ 前缀为输入控件，那么我们可以初始化配置数据， SQL语句如下：

insert into cfg_ypz (fname,cname) values('xgzdw','现工作单位')
insert into cfg_ypz (fname,cname) values('cjgzsj','参加工作时间')

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

范例运行环境

操作系统： Windows Server 2019 DataCenter

数据库：Microsoft SQL Server 2016

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

开发工具：VS2019 C#

AttributeInducingFieldName 方法

设计与实现

AttributeInducingFieldName 方法主要是通过 object[,] 二维对象数组数据源进行提取并根据主控件名与控件ID进行匹配，查找匹配成功则根据配置参数的进行统一属性赋值，其参数设置见下表：

序号	参数名	类型	说明
1	HasTitle	bool	数据集是否包含列名，如果包含则数据输出从第2行开始
2	cfg	ArrayList	必须值，一个配置参数列表，每一个项为一个一维字符串数组，最多有个4个值，项目的数目为必须有2个值或者4个值。（1）2个值的情况，指要赋值控件的前缀，后面为属性名称，如 new string[] { "x_", "onclick" } 表示为按主控件名+x_前缀名进行查找，并赋予 onclick 属性（值根据数据配置表进行设置）（2）4个值的情况，如 new string[]{ "l_", "","x_","" } ，前2个值可以设置为空略过，后两个值为必填写项的设置，第4个值为必填写项的提示字符前缀，如“”号

序号

参数名

类型

说明

HasTitle

bool

数据集是否包含列名，如果包含则数据输出从第2行开始

cfg

ArrayList

必须值，一个配置参数列表，每一个项为一个一维字符串数组，最多有个4个值，项目的数目为必须有2个值或者4个值。

（1）2个值的情况，指要赋值控件的前缀，后面为属性名称，如 new string[] { "x_", "onclick" } 表示为按主控件名+x_前缀名进行查找，并赋予 onclick 属性（值根据数据配置表进行设置）

（2）4个值的情况，如 new string[]{ "l_", "","x_","*" } ，前2个值可以设置为空略过，后两个值为必填写项的设置，第4个值为必填写项的提示字符前缀，如“*”号

方法中会用到 GetReaderData 方法可以访问数据库数据表进行查询结果的提取，并转化为 object[,] 二维数组，具体实现请参考我的文章：《C# Web控件与数据感应之填充 HtmlTable》中的GetReaderData 方法实现代码。

AttributeInducingFieldName 方法实现代码如下：

ArrayList paras=new ArrayList();
string refSql="";
System.Data.CommandType ct=System.Data.CommandType.Text;public void AttributeInducingFieldName(bool HasTitle,ArrayList cfg)
{object[,] ReaderData = GetReaderData("SqlServer","您的连接串",refSql,paras,HasTitle,ct);if (ReaderData == null) return;if (ReaderData.GetLength(1) < 2) return;for (int i = (HasTitle == true ? 1 : 0); i < ReaderData.GetLength(0); i++){string _fieldname = ReaderData[i,0].ToString();string _cname = ReaderData[i, 1].ToString();for (int j = 0; j < cfg.Count; j++){string[] _cfg=(string[])cfg[j];string exName = _cfg[0];string attribute = _cfg[1];string autoReqChar = "";string relaExName = "";if (_cfg.GetLength(0) > 3){relaExName = _cfg[2];autoReqChar = _cfg[3];}Control ctl = FindControlEx(exName+_fieldname);if (ctl != null){if (attribute == ""){if (relaExName != ""){Control ctl2 = FindControlEx(relaExName + _fieldname);if (ctl2 is WebControl){string _checkSchema = ((WebControl)ctl2).Attributes["checkSchema"];if (_checkSchema != null){if (_checkSchema.IndexOf("notnull") != -1){_cname = autoReqChar + _cname;}}}}SetBaseClassText(exName + _fieldname, _cname);}else{if (attribute.ToLower() != "style"){if (((WebControl)ctl).Attributes[attribute] == null){((WebControl)ctl).Attributes[attribute] = _cname;}}else{string[] styles = _cname.Split(';');for (int s = 0; s < styles.Length; s++){string[] style = styles[s].Split(':');if (style.Length > 1){string _key = style[0];string _value = style[1];((WebControl)ctl).Style[_key] = _value;if (_key.ToLower().Trim() == "visible" && _value.ToLower().Trim() == "false"){((WebControl)ctl).Visible = false;}}}}//style}}}}//for rows
}//control inducing fieldnamepublic void SetBaseClassText(string webctl,string values)
{System.Web.UI.Control btnctl;btnctl=FindControlEx(webctl);if(btnctl==null){return;}if(btnctl.GetType()==typeof(System.Web.UI.WebControls.TextBox)){((System.Web.UI.WebControls.TextBox)btnctl).Text=values;}if(btnctl.GetType()==typeof(System.Web.UI.WebControls.Label)){((System.Web.UI.WebControls.Label)btnctl).Text=values;}if(btnctl.GetType()==typeof(System.Web.UI.WebControls.Button)){((System.Web.UI.WebControls.Button)btnctl).Text=values;}if(btnctl.GetType()==typeof(System.Web.UI.WebControls.LinkButton)){((System.Web.UI.WebControls.LinkButton)btnctl).Text=values;}if(btnctl.GetType()==typeof(System.Web.UI.WebControls.HyperLink)){((System.Web.UI.WebControls.HyperLink)btnctl).Text=values;}
}

如何根据 ID 查找控件

FindControlEx 实现了对 FindControl 方法的扩充，如果查找不成功可试图查找是否有母版页，如果存在，则根据母版页模式继续查找。

FindControlEx 方法

FindControlEx 通过传递要查找的服务器容器控件和ID参数，以返回查找到的控件，代码如下：

public Control  FindControlEx(Control FindPage,string ID)
{Control ctl=FindPage.FindControl(ID);if (ctl == null && FindPage.Page.Master != null){ctl=FindPage.Page.Master.FindControl(ID);}return ctl ;
}

调用示例

前端代码请参照准备数据源小节示例：

示例（1）将查询出来的配置数据指定的控件设置为必填写项，并为其自定义属性（cName）进行赋值，代码如下：

string refSql="select fname,cname from cfg_ypz";
System.Data.CommandType ct=System.Data.CommandType.Text;ArrayList cfg = new ArrayList();
cfg.Add(new string[]{ "l_", "","x_","*" });
cfg.Add(new string[] { "x_", "cName" });
AttributeInducingFieldName(true,cfg);

示例（2）将查询出来的配置数据指定的控件为其 onclick 属性进行赋值，代码如下：

string refSql="select fname,'onclick_funtion()' as cname from cfg_ypz";
System.Data.CommandType ct=System.Data.CommandType.Text;ArrayList cfg = new ArrayList();
cfg.Add(new string[] { "x_", "onclick" });
AttributeInducingFieldName(true,cfg);