目录
关于数据感应
CheckBoxList 类
范例运行环境
数据源表设计
角色字典表
用户角色表
AutoValueDBList 方法
原理
设计
实现
调用示例
初始化数据
启动查询模式
使用保存模式
小结
关于数据感应
数据感应也即数据捆绑,是一种动态的,Web控件与数据源之间的交互,本文将继续介绍与数据库提取数据并捆绑到 CheckBoxList 类控件为例,另外同时将控件的值保存回数据库的通用方法。
CheckBoxList 类
System.Web.UI.WebControls.CheckBoxList 类是提供了一组可复选的选项集合,每个选项以true或false 表示其选中状态。其使用方法基于 ListControl 类。
更多 CheckBoxList 类的介绍请参照如下链接:
https://learn.microsoft.com/zh-cn/previous-versions/visualstudio/design-tools/expression-studio-2/cc294907(v=expression.10)
范例运行环境
操作系统: Windows Server 2019 DataCenter
.net版本: .netFramework4.7.1 或以上
开发工具:VS2019 C#
数据提取:在这里我们以MS SQL Server 2016为例
数据源表设计
我们假设要为用户添加角色权限,则需要涉及两个表:
角色字典表
表(sys_chars)用于列出可用的角色,其结构如下:
序号 | 字段名 | 类型 | 说明 | 备注 |
---|---|---|---|---|
1 | cid | uniqueidentifier | 唯一ID | 用于后续方法使用 |
2 | charname | nvarchar(30) | 角色名称 |
其数据示例如下:
用户角色表
表(sys_UserChars)用于存储用户的可用角色(用户ID+角色ID 唯一),其结构如下:
序号 | 字段名 | 类型 | 说明 | 备注 |
---|---|---|---|---|
1 | user_cid | uniqueidentifier | 用户ID | 用户的ID值 |
2 | char_cid | uniqueidentifier | 角色名称 | 用记所属的角色ID值 |
其示例数据如下:
AutoValueDBList 方法
原理
我们需要提取 sys_chars (角色字典表) 数据绑定到 CheckBoxList 控件上,用于显示可用的角色名称。绑定后通过 AutoValueDBList 方法的查询模式,从 sys_UserChars (用户角色表)提取数据并与 CheckBoxList 上的项进行比对,存在的则选中。同理,使用 AutoValueDBList 方法的保存模式,则将用户在 CheckBoxList 上的选项逐一保存到 sys_UserChars (用户角色表)里。
设计
AutoValueDBList 方法主要分查询模式和保存模式,在保存模式的情况下返回成功影响的行数,其参数说明如下表:
序号 | 参数名 | 类型 | 说明 |
---|---|---|---|
1 | strConn | string | 对应数据库的连接字符串 |
2 | _object | ListControl | 要感应的 ListControl 类控件,这里泛指 CheckBoxList |
3 | AutoType | string | 两种值可选择,“query” 为查询模式,“save” 为保存模式 |
4 | keyFieldType | string | 连接的目标表的关键字字段类型,如 uniqueidentifier,比如sys_UserChars 中的 user_cid 字段类型 |
5 | linkKeyValue | string | 连接的目标表的关键字段的值,比如sys_UserChars 中的 user_cid 字段的值 |
6 | Tablename | string | 要连接的目标表比如 sys_UserChars |
7 | KeyField | string | 连接的目标表的关键字字段名,比如sys_UserChars 中的字段 “user_cid” |
8 | KeyField2 | string | 连接的目标表的第二关键字字段名,比如sys_UserChars 中的字段 “char_cid” |
9 | CidFieldName | string | 指定连接目标表的唯一标识字段名,这里仅允许使用 uniqueidentifier 的类型字段,如无则默认不参于 insert 操作,设置则表示其值为 newid() |
实现
AutoValueDBList 方法完整代码如下:
public int AutoValueDBList(string strConn,ListControl _object,string AutoType,string keyFieldType,string linkKeyValue,string Tablename,string KeyField,string KeyField2,string CidFieldName)
{int rv=-1;SqlDbType type=GetSqlDbType(keyFieldType);SqlConnection Conn = new SqlConnection(strConn );SqlCommand Cmd = new SqlCommand();Cmd.Connection = Conn;if(AutoType=="save"){Cmd.CommandText = " delete from "+Tablename+" where "+KeyField+"=@"+KeyField;SqlParameter para1=new SqlParameter("@"+KeyField,type);para1.Value=(keyFieldType.ToLower()=="uniqueidentifier"?(object)(new Guid(linkKeyValue)):(object)linkKeyValue);Cmd.Parameters.Add(para1);try{Conn.Open();Cmd.ExecuteNonQuery();Cmd.CommandText = " insert into "+Tablename+"("+KeyField+","+KeyField2+") values(@"+KeyField+",@"+KeyField2+")";if(CidFieldName!=""){Cmd.CommandText = " insert into "+Tablename+"("+CidFieldName+","+KeyField+","+KeyField2+") values(newid(),@"+KeyField+",@"+KeyField2+")";}SqlParameter para2=new SqlParameter("@"+KeyField2,type);Cmd.Parameters.Add(para2);int success=0;for(int i=0;i<_object.Items.Count;i++){string _value=_object.Items[i].Value;if(!_object.Items[i].Selected){continue;}para2.Value=(keyFieldType.ToLower()=="uniqueidentifier"?(object)(new Guid(_value)):(object)_value);int si=Cmd.ExecuteNonQuery();success+=si;}return success;}catch (Exception ex){return rv;}finally{Conn.Close();Conn.Dispose();}}if(AutoType=="query"){SqlDataReader myDr;Cmd.CommandText = " select "+KeyField2+" from "+Tablename+" where "+KeyField+"=@"+KeyField;SqlParameter para1=new SqlParameter("@"+KeyField,type);para1.Value=(keyFieldType.ToLower()=="uniqueidentifier"?(object)(new Guid(linkKeyValue)):(object)linkKeyValue);Cmd.Parameters.Add(para1);try{Conn.Open();myDr=Cmd.ExecuteReader();for(int i=0;i<_object.Items.Count;i++){_object.Items[i].Selected=false;}rv=0;while(myDr.Read()){rv++;string _dbkey=myDr[KeyField2].ToString();for(int i=0;i<_object.Items.Count;i++){string _value=_object.Items[i].Value;if(_value==_dbkey){_object.Items[i].Selected=true;}}}}catch (Exception ex){return rv;}finally{Conn.Close();Conn.Dispose();}}return rv;}public SqlDbType GetSqlDbType(String TypeInfo)
{TypeInfo=TypeInfo.ToLower();//Byteif((TypeInfo=="varchar")||(TypeInfo=="system.string")){return SqlDbType.VarChar;}if((TypeInfo=="bigint")||(TypeInfo=="system.int64")){return SqlDbType.BigInt;}if((TypeInfo=="binary")||(TypeInfo=="system.byte[]")){return SqlDbType.Binary;}if((TypeInfo=="bit")||(TypeInfo=="system.boolean")){return SqlDbType.Bit;}if((TypeInfo=="char")||(TypeInfo=="system.char")){return SqlDbType.Char;}if((TypeInfo=="datetime")||(TypeInfo=="system.datetime")){return SqlDbType.DateTime;}if((TypeInfo=="decimal")||(TypeInfo=="system.decimal")){return SqlDbType.Decimal;}if((TypeInfo=="float")||(TypeInfo=="system.double")){return SqlDbType.Float;}if(TypeInfo=="image"){return SqlDbType.Image;}if((TypeInfo=="int")||(TypeInfo=="system.int32")){return SqlDbType.Int;}if((TypeInfo=="money")||(TypeInfo=="system.decimal")){return SqlDbType.Money;}if(TypeInfo=="nchar"){return SqlDbType.NChar;}if(TypeInfo=="ntext"){return SqlDbType.NText;}if(TypeInfo=="nvarchar"){return SqlDbType.NVarChar;}if((TypeInfo=="real")||(TypeInfo=="system.single")){return SqlDbType.Real;}if(TypeInfo=="smalldatetime"){return SqlDbType.SmallDateTime;}if((TypeInfo=="smallint")||(TypeInfo=="system.int16")){return SqlDbType.SmallInt;}if(TypeInfo=="smallmoney"){return SqlDbType.SmallMoney;}if(TypeInfo=="text"){return SqlDbType.Text;}if((TypeInfo=="timestamp")||(TypeInfo=="system.timespan")){return SqlDbType.Timestamp;}if((TypeInfo=="tinyint")||(TypeInfo=="system.byte")){return SqlDbType.TinyInt;}if((TypeInfo=="uniqueidentifier")||(TypeInfo=="system.guid")){return SqlDbType.UniqueIdentifier;}if(TypeInfo=="varbinary"){return SqlDbType.VarBinary;}if(TypeInfo=="variant"){return SqlDbType.Variant;}return SqlDbType.VarChar;
}// end GetSqlDbType function
调用示例
初始化数据
假设前端 UI 有 ID 为 CBL 的 CheckBoxList 控件,则调用的示例代码如下:
simpleDataListEx("sqlserver","数据库连接串","select cid, charname from sys_chars", null, "cid", "charname", CBL, false, "", "","");
有关 simpeDataListEx 的使用方法请阅读我的文章《C# Web控件与数据感应之 Control 类》。
启动查询模式
初始化完成后,启动 AutoValueDBList 方法的查询模式,进行比对操作。示例代码如下:
string user_cid_value="1F044A84-9154-466B-9B9F-894282625729";
AutoValueDBList("你的数据库连接串",CBL, "query", "uniqueidentifier", user_cid_value, "sys_userchars", "user_cid", "char_cid");
使用保存模式
当用户重新进行复选操作时,可以将结果提交给数据库进行保存。示例代码如下:
string user_cid_value="1F044A84-9154-466B-9B9F-894282625729";
AutoValueDBList("你的数据库连接串",CBL,"save","uniqueidentifier",user_cid_value,"sys_userchars","user_cid","char_cid","cid");
小结
范例中使用的MS SQL SERVER 数据库,我的下载资源还提供了 Oracle 9i及达梦数据库的驱动链接库,请下载我的资源:
https://download.csdn.net/download/michaelline/89235824
我们可以根据需要改造方法,另外 AutoValueDBList 方法基于 ListControl 类,我们可以根据实际的需要进行使用和改造。感谢您的阅读,希望本文能够对您有所帮助。