C# Web控件与数据感应之 Control 类-阿里云开发者社区

C# Web控件与数据感应之 Control 类

2024-05-06 102

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

本文涉及的产品

RDS SQL Server Serverless，2-4RCU 50GB 3个月

云数据库 RDS SQL Server，基础系列 2核4GB

可视分析地图（DataV-Atlas），3 个项目，100M 存储空间

简介： C# Web控件与数据感应之 Control 类

关于数据感应

数据感应也即数据捆绑，是一种动态的，Web控件与数据源之间的交互，诸如 ListControl 类类型控件，在我的文章《C# Web控件与数据感应之 ListControl 类》里有详细的介绍。本文将继续介绍以与数据库提取数据并捆绑控件为例，讲解 C# 创建适用于 Control 类的更加广泛兼容的通用方法。

Control 类

Control 类是包括自定义控件、用户控件和页在内的所有 ASP.NET 服务器控件的基类，System.Web.UI.HtmlControls、System.Web.UI.WebControls 等都是从此基类中派生。在这里我们以 Control 类的实例化控件进行判断用户的控件类型，以决定其绑定数据后的显示设置方式。

更多 Control 类的介绍请参照如下链接：

https://learn.microsoft.com/zh-cn/previous-versions/dotnet/netframework-1.1/983zwx2h(v=vs.80)

范例运行环境

操作系统： Windows Server 2019 DataCenter

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

开发工具：VS2019 C#

数据提取：在这里我们以能够支持 Oracle 9i、MS SQL Server 2016、国产达梦数据 8 的通用数据库内容提取方法为例，生成数据源需要利用 ADO.NET 中的数据提供者对象包括IDbConnection、IDbCommand、IDbDataParameter等，如何使用这些对象请参考我的文章：

《C#实现 IDbConnection / IDbCommand 等相关通用数据接口》

simpleDataListEx方法

设计

simpleDataListEx 方法可以下达SQL命令及配置相关参数，将数据源感应到指定的 Control 类控件上，其参数说明如下表：

序号	参数名	类型	说明
1	DbServerType	string	目前支持 "oracle"、 "dm8"，其它字符串均视为 MS SQL Server
2	strConn	string	对应数据库的连接字符串
3	sql	string	要执行的SQL语句命令行
4	paras	ArrayList	要赋值的参数对象，逐个添加到ArrayList里，请注意参数为实体数据参数对象，如 MS SQL Server ，请传递如下代码： ArrayList.Add(new SqlParameter("参数名",参数值));
5	keyfield	string	提取数据源成功时，用于捆绑ListItem.Value 的字段名
6	displayfield	string	提取数据源成功时，用于捆绑ListItem.Text 的字段名
7	_object	System.Web.UI.WebControls.Control	要捆绑的目标 Control 对象，方法将根据控件类型判断，以决定如何进行赋值，此说明将再后续表格进行说明
8	allownull	bool	是否允许添加一个空项，指捆绑成功后是否还需要添加一个空项，该空项会自动增加到第一个选项（如Value为空，Text 显示为 “未选择” ），且处于默认选择状态，否则会自动默认为数据源的第一个选项
9	allownullvalue	string	当允许添加一个空项时（allownull为true），指定空项存储的 Value 值
10	allownulltext	string	当允许添加一个空项时（allownull为true），指定空项存储的 Text 值
11	defaultvalue	string	指定一个默认查找值，当数据源绑定后进行二次查找且定位

对于 System.Web.UI.WebControls.Control _object 的解析判断如下表：

序号	控件类型	有效赋值属性	取值说明
1	System.Web.UI.HtmlControls. HtmlGenericControl	InnerText	取keyfield字段值
2	System.Web.UI.WebControls. Label	Text	取keyfield字段值
3	System.Web.UI. WebControls.TextBox	Text	取keyfield字段值
4	System.Web.UI. HtmlControls.HtmlInputText	Value	取keyfield字段值
5	System.Web.UI.WebControls. DropDownList	DataTextField DataValueField	DataTextField取displayfield字段值 DataValueField取keyfield字段值
6	System.Web.UI.WebControls. ListBox	DataTextField DataValueField	DataTextField取displayfield字段值 DataValueField取keyfield字段值
7	System.Web.UI.HtmlControls. HtmlSelect	DataTextField DataValueField	DataTextField取displayfield字段值 DataValueField取keyfield字段值

实现

simpleDataListEx 方法完整代码如下：

public string simpleDataListEx(string DbServerType,string strConn,string sql,ArrayList paras,string keyfield,string displayfield,System.Web.UI.Control _object,bool allownull,string allownullvalue,string allownulltext,string defaultvalue)
{
      string rv="";
      string strConn =ConfigurationSettings.AppSettings[ConnKeyString];
      if(ConnString!="")
      {
        strConn=ConnString;
      }
      System.Data.IDbConnection Conn=GetConnection(DbServerType,strConn);
      System.Data.IDbCommand Cmd=GetCommand(DbServerType,sql,paras,Conn);
      System.Data.IDataReader myDr=GetDataReader(DbServerType);
      try
      {
        Conn.Open();
                if (DbServerType.ToLower() == "dm8")
                {
                    myDr = Cmd.ExecuteReader() as DmDataReader;
                }
                else
                {
                    myDr = Cmd.ExecuteReader();
                }
                if (_object.GetType()==typeof(System.Web.UI.HtmlControls.HtmlGenericControl))
        {
          if(myDr.Read())
            ((System.Web.UI.HtmlControls.HtmlGenericControl)_object).InnerText=myDr[keyfield].ToString();
        }
        if(_object.GetType()==typeof(System.Web.UI.WebControls.Label))
        {
          if(myDr.Read())
            ((System.Web.UI.WebControls.Label)_object).Text=myDr[keyfield].ToString();
        }
        if(_object.GetType()==typeof(System.Web.UI.WebControls.TextBox))
        {
          if(myDr.Read())
            ((System.Web.UI.WebControls.TextBox)_object).Text=myDr[keyfield].ToString();
        }
        if(_object.GetType()==typeof(System.Web.UI.HtmlControls.HtmlInputText))
        {
          if(myDr.Read())
          ((System.Web.UI.HtmlControls.HtmlInputText)_object).Value=myDr[keyfield].ToString();
        }
        if(_object.GetType()==typeof(System.Web.UI.WebControls.DropDownList))
        {
          ((System.Web.UI.WebControls.DropDownList)_object).DataSource = myDr;
          ((System.Web.UI.WebControls.DropDownList)_object).DataTextField = displayfield;
          ((System.Web.UI.WebControls.DropDownList)_object).DataValueField = keyfield;
        }
        if(_object.GetType()==typeof(System.Web.UI.WebControls.ListBox))
        {
          ((System.Web.UI.WebControls.ListBox)_object).DataSource = myDr;
          ((System.Web.UI.WebControls.ListBox)_object).DataTextField = displayfield;
          ((System.Web.UI.WebControls.ListBox)_object).DataValueField = keyfield;
        }
        if(_object.GetType()==typeof(System.Web.UI.HtmlControls.HtmlSelect))
        {
          ((System.Web.UI.HtmlControls.HtmlSelect)_object).DataSource = myDr;
          ((System.Web.UI.HtmlControls.HtmlSelect)_object).DataTextField = displayfield;
          ((System.Web.UI.HtmlControls.HtmlSelect)_object).DataValueField = keyfield;
        }
        _object.DataBind();
        myDr.Close();
 
      }
      catch (Exception e)
      {
        rv=e.Message;
      }
      finally
      {
        Conn.Close();
        Conn.Dispose();
      }
      if(allownull)
      {
 
        if(_object.GetType()==typeof(System.Web.UI.WebControls.DropDownList))
        {
          ((System.Web.UI.WebControls.DropDownList)_object).Items.Insert (0,new ListItem(allownulltext,allownullvalue));
          ((System.Web.UI.WebControls.DropDownList)_object).SelectedIndex=((System.Web.UI.WebControls.DropDownList)_object).Items.IndexOf(((System.Web.UI.WebControls.DropDownList)_object).Items.FindByValue(defaultvalue));
        }
        if(_object.GetType()==typeof(System.Web.UI.WebControls.ListBox))
        {
          ((System.Web.UI.WebControls.ListBox)_object).Items.Insert (0,new ListItem(allownulltext,allownullvalue));
          ((System.Web.UI.WebControls.ListBox)_object).SelectedIndex=((System.Web.UI.WebControls.ListBox)_object).Items.IndexOf(((System.Web.UI.WebControls.ListBox)_object).Items.FindByValue(defaultvalue));
        }
        if(_object.GetType()==typeof(System.Web.UI.HtmlControls.HtmlSelect))
        {
          ((System.Web.UI.HtmlControls.HtmlSelect)_object).Items.Insert (0,new ListItem(allownulltext,allownullvalue));
          ((System.Web.UI.HtmlControls.HtmlSelect)_object).SelectedIndex=((System.Web.UI.HtmlControls.HtmlSelect)_object).Items.IndexOf(((System.Web.UI.HtmlControls.HtmlSelect)_object).Items.FindByValue(defaultvalue));
        }
      }
      return rv;
}//simpleDataListEx
 
 
 
public System.Data.IDbConnection GetConnection(string DbServerType,string ConnectionString)
{
      IDbConnection con = null;
      switch (DbServerType.ToLower())
      {
        case "oracle":
          con = new OracleConnection(ConnectionString);break;
                case "dm8":
                    con = new DmConnection(ConnectionString); break;
                default:
          con = new SqlConnection(ConnectionString);   break;
      }
      return con;
 
}
public IDbCommand GetCommand(string dbservertype,string cmdText,ArrayList paras,IDbConnection con)
{
      IDbCommand cmd = null;
      switch (dbservertype.ToLower())
      {
        case "oracle": cmd = new OracleCommand(cmdText,(OracleConnection)con);
          break;
                case "dm8":
                    cmd = new DmCommand(cmdText, (DmConnection)con);
                    break;
                default:    cmd = new SqlCommand(cmdText,(SqlConnection)con);        break;
      }
      if(paras!=null)
      {
        for(int i=0;i<paras.Count;i++)
        {
          cmd.Parameters.Add(GetParameter(dbservertype,paras[i]));
        }
      }
      return cmd;
}
public System.Data.IDbDataParameter GetParameter(string dbservertype,object paras)
{
      IDbDataParameter para = null;
      switch (dbservertype.ToLower())
      {
 
        case "oracle": para =(OracleParameter)paras; 
          break;
                case "dm8":
                    para =  (DmParameter)paras;
                    break;
                default: para =(SqlParameter)paras; break;
      }
      return para;
}

调用示例

数据源

我们以 MS SQL SERVER 为例，提取某一项目ID的可选择人员类型列表，如下图数据显示：

表（pub_type）设计基本情况如下表：

序号	字段名	类型	说明	备注
1	xm_cid	uniqueidentifier	项目ID
2	value	nvarchar(100)	存储的值
3	text	nvarchar(100)	存储的显示值	用户可以看到的选择时的呈现值
4	sortid	int	排序号

调用

假设前端 UI 有 ID 为 TB 的 TextBox (文本框) 控件和 ID 为 DDL 的 DropDownList (下拉列表框) 控件，则调用的示例代码如下：

ArrayList paras = new ArrayList();
string xm_cid="E5FB9BF5-6CB6-4792-B105-C4453028925D"; //项目ID
paras.Add(new SqlParameter("@cid", xm_cid));
simpleDataListEx("sqlserver","数据库连接串","select value,text from pub_type where xm_cid=@cid order by sortid", paras, "text", "value", TB, true, "", "","");
simpleDataListEx("sqlserver","数据库连接串","select value,text from pub_type where xm_cid=@cid order by sortid", paras, "text", "value", DDL, true, "", "","");

显示结果如下图：

从图中我们可以看出，对于文本框只提取第一条记录的Value值，对于可单选项的下拉列表框可以显示多条记录。

小结

范例中所需数据库驱动链接库，请下载我的资源：

https://download.csdn.net/download/michaelline/89235824

本方法适用于所以对应说明表中的 Control 类类型控件，我们可以根据自己的实际需要扩充范围类型的控件和改造符合自己要求的功能，感谢您的阅读，希望本文能够对您有所帮助。