.net 通用数据库概念
一： asp.net通用数据库访问层源码之公用属性
公共属性
公共属性在CBaseConfig类别中，可以在程序中可以直接以CBaseConfig.appRoot取得)
1. appRoot
string, 应用程序物理路径（格式：c:\myDir\）
2. VirtualPath
string,应用程序虚拟路径（格式：/myWeb/）
3. EncryptKey
string,用于加密资料的密钥
4. IsCache
bool, true/false(default)从数据库中取的数据是否使用cache。
5. SqlCacheDependPath
string, 从数据库中取的数据cache依的目录(格式：c:\myDir\)
6. SmtpServer
string, 发送e-mail的SMTP服务器名称或IP地址
7. AllViewCount
int, 访问系统的总人次数。
8. DayViewCount
int, 访问系统的当日人次数。
9. AppVersion
String, WEB应用程序当前版本，格式：V版本号.年月日.时分,如V3.20050820.1403,表示版本号是3，最后更新日期是2005/8/20 14:03
10. EnablePageCache
bool, true(default)/false使用/不使用页面catch
11. PageCacheExpiresInSeconds
int, 页面catch过期时长(秒,default 3600)
12. EnableSsl
bool, true/false(default)是否使用SSL加密传送数据
二： asp.net通用数据库访问层源码之公共函数
公共函数
公共方法在CBaseConfig类别中，在程序中直接以CBaseConfig.ReadStting()调用。
1. OnApplicationStart
OnApplicationStart (stringprojectDLL)---初始化CbaseConfig类，必须在Global.asax.cs的Application_Start(Objectsender, EventArgs e)中执行
projectDLL=WEB程序主DLL文件(不含路径)，该DLL在每次修改时都要变，一般是WEB项目名的DLL（用于版本计算）
2. OnApplicationEnd
OnApplicationEnd()—系统结束时，调用该函数，清除所有资源
3. AddViewCount
AddViewCount(string countKey)-- 累加计数值(访问系统的人数)。
返回累加后的总计数值(AllViewCount=总的计数值，DayViewCount=当日计数值)
countKey=在系统设定文件(AppSetting.xml)中的计数值的key。
4. RemoveAllCache
RemoveAllCache()--清除所有Cache(不清除系统使用的cache(以'PSYS_'开头))
5. ReadWebConfig
ReadWebConfig(string key, stringdefaultValue)—从WEB.Config文件中的<appSettings>中取参数值
key=web.config文件中<appkey=’’>中的key值,
defaultValue=默认值，如果没有设定则用该值。
6. ReadAppConfig
ReadAppConfig(string key, objectdefaultValue)—从系统配置文件(WebFrame.config)中读取参数值
key=<app key=’’>中的key值,defaultValue=默认值，如果没有设定则用该值
7. ReadSetting
ReadSetting(string key, objectdefaultValue)—从系统设定文件(AppSetting.xml)中读取参数值
key=<app key=’’>中的key值,defaultValue=默认值，如果没有设定则用该值
8. WriteSetting
WriteSetting(string key, stringsetting)—将key加入系统配置文件(AppSetting.xml)中(如果没有该key则生成)。(存入后，格式为：<appkey=’’ value=’’/>)，成功返回true,失败返回false
key=<app key=’’>中的key值,defaultValue=默认值，如果没有设定则用该值
9. SaveSetting
SaveSetting()—WriteSetting()并没有保存加入的key,当所有key加完后，调用该函数来保存。成功返回true,失败返回false.
10. GetMessage
GetMessage(string MsgId, stringLanguageName)—取提示信息内容，该信息放在XML文件中(该文件由配置文件(WebFrame.config)中<appSettings>中key="Web.MsgPath"的值及语言决定，文文件放在Web.MsgPath下，文件名是语言名.xml如zh-CHS.xml)
MsgId=信息ID，请参考WebFrameMsg.xml
LanguageName=使用的言语特性(不设定或为空，则使用系统设定zh-CHT),zh-CHT版 ;zh-CHS 简体版;en 英文版 ja-JP 日文版
11. CreateJSMsg
CreateJSMsg(string[] MsgIds, string LanguageName, booladdScript)--生成JS显示的讯息(从讯息文件(*.xml)中取)，这些讯息在JS函数中使用。
返回格式：<scriptlanguage='javascript'>S0001="xxx";S0002="xxx";...</script>
MsgIds=要生成的讯息ID，多个，这些讯息在讯息文件中(如zh-CHS.xml)。
LanguageName=使用的言语特性(不设定或为空，则使用系统设定zh-CHT),zh-CHT 繁体版 ;zh-CHS 简体版;en 英文版 ja-JP 日文版
addScript=true(预设):结果加上<scriptlanguage='javascript'></script>
12. ExecuteJS
ExecuteJS(string jsCodes)--执行一段JS代码。返回含<script>的jsCodes代码。
jsCodes=要执行的JS代码,必须是正确的、完整的代码,不含<scriptlanguage='javascript'>
13. ShowJsMsg
ShowJsMsg(string msg, string url, boolIsBack)—显示指定的讯息，并返回指定页面。
msg=要显示的讯息，如果为空则显示no message.
url=返回的页面url,=null或'':返回上一页面history.go(-1),只有一个数字:返回history.go(-url),以');'或')'结束:url=JS函数，其它:url=返回的页面url
IsBack= true:返回指定的url页面，false:不返回.
三： asp.net通用数据库访问层源码
1.在WEB系统的根目录下建一个存放系统配置文件的目录(如AppConfig)，设定为只读，WEB无任何权限(在IIS管理员中设定)。同时建如下子目录：
(1) data—存放SQL配置文件(如TB_Users.xml)。
(2) msg—存放系统讯息文件(如zh-CHS.xml)
(3) log—存放系统错误日志文件，必须有写入权限。
(4) setting—存放系统设定文件(如AppSetting.xml) ，必须有写入权限。
2. 设定系统配置文件(WebFrame.config)及Web.config。
3. 在Global.asax.cs文件中：
(1) 加入：using WebFrame.Config;
(2) 在Application_Start()中：
CBaseConfig.OnApplicationStart(Context.Cache,
Context.Server.MapPath(Context.Request.Application Path),
Context.Request.ApplicationPath,”project.dll”);
(3) 在Session_Start()中：
CBaseConfig.AddViewCount("App.UserCount"); //计数器+1
(4) 在Application_Error()和Application_End()中：
CBaseConfig.OnApplicationEnd();
4.
架构
WebFrame架构目前有以下几个名字空间(以后也许还会扩充)：
1.WebFrame.Base：包含CBaseDAO、CBaseDAOContext、CSecurity、CMail等类别
2.WebFrame.Config：包含CBaseConfig、CEncrypt、CWebFrameException等类别。
3. WebFrame.DB：包含所有对数据库操作的类别，请参考CDBConn.doc说明
4. WebFrame.UserServices：包含对用户数据、权限数据等操作的所有类别。
5. WebFrame.UserSimple：包含对用户数据、简单权限数据等操作的类别。
6. WebFrame.UI：包含前端页面使用的公用类别。
7. WebFrame.File：包含文件上载、下载操作的所有类别
8. WebFrame.OWC：包含用MS OWC11生成统计图的类别
其中WebFrame.Config、WebFrame.DB、WebFrame.Base是最基本、也是必须的。
使用WebFrame来开发WEB项目/项目时，至少分2层（2个项目/项目），业务逻辑层和接口层：
1.业务逻辑层：包含所有业务逻辑层的类别库（项目/项目），该类别库的所有类别都继承CBaseDAO或CBaseSimpleDAO、CRightDAO类别。类别库中至少包含WebFrame.Base、WebFrame.Config、WebFrame.DB三个名字空间，如果需要用到用户及权限数据，还必须包含WebFrame.UserSimple或 WebFrame.UserServices。
在一般应用中，业务逻辑层类别库中只需要用CEntityDAO类别来操作数据库就够了：
CEntityDAO dao=new CEntityDAO("my.xml",m_LanguageName);
DataSet ds= dao.SearchDataset("SqlName");
…………
如果CEntityDAO类别不能满足要求，或对效能要求比较高，可直接使用CDBConn类别来操作数据库：
CDBConn dbConn=CDBConn.Instance(m_ConnKey,m_LanguageName);
dbConn.Open();
dbConn.BeginTrans(); //开始事务
dbConn. ExecuteNonQuery(strSql);
…… //其它方法
dbConn.CommitTrans();
dbConn.Close();
…………
当使用CEntityDAO类别时，系统用到的所有SQL语句全部保存在XML格式的多个配置文件中(请用DBMap.exe来维护)。一个业务逻辑类用一个配置文件中（将该类用到的所有SQL全部放到一个文件中），这样有多少个业务类，就应该有多少个配置文件。SQL名称最好与类别中的方法名称相同，这样维护起来比较方便。
类别说明及详细使用方法请参考＜CDBConn.doc＞、＜CEntityDAO.doc＞、<CBaseDAO.doc>。
2.界面层：在前端接口项目/项目(WEB应用程序)中，至少包含WebFrame.Base、WebFrame.Config，其它可根据需要加入。
在接口层的ASPX或HTM页面中，存取参数值（数据表字段值）的form元素的名称必须和参数名（数据表id）相同，这样就可以用如下方法取得参数值，然后传到业务逻辑类别中：
(1) DataSet paramDataset=new DataSet;
paramDataset.ReadXml(Request.InputStream);
(2) NameValueCollection paramValues=newNameValueCollection();
paramValues.Add(Request.Form);
paramValues.Add(Request.QueryString)
CSimpleUser myCls=new CSimpleUser(); //业务逻辑层类别
myCls.SetLanguage(LanguageName); //设定使用的言语
myCls.InsertRole(paramValues); //新增角色资料
或
myCls.InsertRole(paramDataset); //新增角色资料
在WebFrame.UI中提供了一些前端接口用的公用类别，可根据情况使用或继承这些类别（也可不用），其中PageBaseDAO类别已经包含以上的paramDataset和paramValues参数，直接使用即可
四： asp.net通用数据库访问层源码之权限
权限
WebFrame包含完整的用户数据维护和权限维护功能，包括用户、群组、角色、级别，从简单到复杂的系统都能满足。注意：TB_Function表中的SqlName字段，用于设定该功能使用的SqlName(在sql配置文件中)，格式是： sql配置文件名/SqlName，多个用“,(逗号)”隔开(如：TB_User.xml/Insert,TB_Role.xml/Insert)，如果该功能只用配置文件，则只输入配置文件名(如：TB_User.xml,TB_Role.xml)。如果该功能没有对应的Sql名或配置文件名，则可指定一个唯一的名称(如1001,Users)，或功能编号(FuncNo)，在程序中用myRight(SqlName)来判断是否有权限，其中的SqlName就是TB_Function表中的SqlName字段指定的名称或编号。
根据需要，又分为简单和完全权限2种：
1.
简单权限：所有功能都放在WebFrame.UserSimple名字空间中，有3个类别(CUser,CRole,CFunction)（配置文件是TB_SimpleUser.xml,TB_SimpleUser.xml,TB_SimpleUser.xml）。没有群组和角色级别功能，一个用户只有一个角色(或当作群组)，权限只有允许(查询、新增、修改、删除)/不允许。用于对权限要求比较简单的系统。
用到的资料表有：TB_Function、TB_Role、TB_RoleRight、TB_Users等4个。
用到的存储过程有：
(1) UP_TB_RoleRight_GetRightById(共享)
(2) UP_Simple_GetMenuByFuncNo(简单权限专用)
(3) UP_Simple_GetUserRight(简单权限专用)
(4) UP_Simple_GetRoleRight(简单权限专用)
(5) UP_Simple_SetRoleRight(简单权限专用)
(6) UP_Simple_Login(简单权限专用)
(7) UP_TB_RoleRight_GetRoleRight(共享)（不用）
(8) UP_TB_Function_DelAllFuncByNo(共享)（不用）
用到的函数：UF_TB_Users_GetUserCountByGroup（公用）(可选，用于取得该群组的用户数)
2.
完全权限：具有完整的、复杂的权限控制功能，包括群组、角色级别。权限不仅有允许(1查询、2新增、3修改、4删除)/不允许，还有群组范围、角色（职务）级别控制。用于对权限要求高的系统，如OA系统、工作流等。包含在WebFrame.UserServices中的所有类别中。
使用的配置文件有：TB_code.xml、TB_function.xml、TB_group.xml、TB_role.xml、TB_user.xml。
用到的数据表（所有以TB_开头的数据表）。除包括简单权限用到的数据表外，还用到：TB_CdType、TB_Codes、TB_Group、TB_GroupInRole、TB_RoleLevel。
用到的存储过程（所有以UP_TB_开头的存储过程，但不含“简单权限专用”，共26个）。
用到的函数（所有以UF_TB_开头的函数：UF_TB_Role_GetGroupRole、UF_TB_Role_GetUserRole，UF_TB_Users_GetUserCountByGroup,共3个）。
五： asp.net通用数据库访问层源码之多语言
多语言版
WebFrame 支持多国语言显示，但必须遵守以下原则：
1.
所有需要显示多国语言的信息，都保存在XML文件中(格式参考zh-CHT.xml，在程序中用CbaseConfig.GetMessage(MsgId)取得要显示的信息)，一个语言版本保存一个XML文件，文件名用语言特性名(如繁体中文zh-CHT.xml，其它请参考CultureInfo类别说明)，并统一放在一个目录下，在配置文件(WebFrame.config)中指定该目录。(参阅WebFrame.config)。
2.
如果一个语言用一个数据库(数据库结构必须完全一样)，则数据库的ConnKey后必须加上“.言语名称”。
如“DB.ConnString.zh-CHS”或“DB.ConnString_DbType.zh-CHS”，但在指定ConnKey时，不用“.言语名称”，如只用DB.ConnString。
3.
web.config中设定使用utf-8编码，如下：
<globalization requestEncoding="utf-8"responseEncoding="utf-8" />
所有文件最好都保存为“utf-8(有签章)”的格式。
4.
在用QueryString传送中文时，必须先进行编码：
(1)
在CS中用HttpUtility.UrlEncode(string),或用Server.UrlEncode(string)来编码,(不要用HttpUtility.HtmlEncode(string)或Server.HtmlEncode(string))。
(2)
在JS中用escape(string)来编码。
(3)
在JS中接收用(string)译码，在CS中接收不用译码，直接使用，如:
string s=Request[“s”];
或string s=Request.Params[“s”] ;
5.
采用下列2种方法来实现多言语版本：
(1)
每个言语有不同的界面程序(ASPX)，并放到不同的目录中，如简体版放到 chs目录，繁体版放到cht目录，每个目录下都有一个web.config文件，用于设定该目录使用的言语(只有该行设定):
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<appSettings>
<add key="Web.Language" value="zh-CHT"/>
</appSettings>
</configuration>
在程序中用GetMessage(MsgId)取得系统显示讯息。
此方法用于不同的言语，界面程序不一样的系统。
(2)
当不同言语使用同一界面程序(ASPX)时，界面程序类(ASPX.CS)继承MultiLangPage.cs类(在WebFrame.UI中)，用LanguageName=’言语名称’来指定使用的言语(只需用一次)，然后可用LanguageName取得该用户当前使用的言语，在程序中用MultiLangPage的GetMessage(MsgId)和CreateJSMsg(MsgIds)来取得系统显示讯息(页面中，需要多言语的文字都放在讯息文件中)。在使用业务逻辑类时，必须用SetLanguage(LanguageName)来指定使用的言语。在使用CDBConn、CEntityDAO及CBaseDAO时，也要显示指定言语名称LanguageName。
6.
WebFrame只解决程序中显示信息的多国语言的问题，而要完全解决多国语言的问题，必须在设计数据库时就要考虑(可采用一种言语用一个数据库来保存，数据库结构要一样)。
global.asax.cs protected void Application_Start(Object sender,EventArgs e)
...{
CBaseConfig.OnApplicationStart("project.dll");
}
protected void Application_Error(Object sender, EventArgse)
...{
CBaseConfig.OnApplicationEnd();
}
protected void Application_End(Object sender, EventArgs e)
...{
CBaseConfig.OnApplicationEnd();
}
protected void Session_Start(Object sender, EventArgs e)
...{
CBaseConfig.AddViewCount("UserCount");//计数值
…
}
web.config
Web.config之appSettings配置说明
<system.web>
……
<!--设定上传档案最大K数(<20M)-->
<httpRuntime maxRequestLength="20000"executionTimeout="180" />
</system.web>
<appSettings>
<!—系统配置文件名(如果是物理路径，则必须有:\的符号(如c:aa.xml)，否则以网站根目录为准，但不包含根路径(如myDir\aa.xml)，预设是网站根目录下的AppConfig\WebFrame.config)-->
<add key="WebFrame.Config" value=""/>
<!--使用的言语特性(不设定或为空，则使用系统设定zh-CHT),zh-CHT 繁体版;zh-CHS 简体版 ;en 英文版 ja-JP 日文版-->
<add key="Web.Language" value="zh-CHT"/>
</appSettings>
六： asp.net通用数据库访问层源码之CDBConn类
数据库访问接口类，该类可访问不同数据库系统，使用时只调其Instance(ConnString)即可。该类在WebFrame.DB名字空间里
使用方法
属性说明
1 Connection
IdbConnection，数据库连接对象。
函数说明
1 Instance()
根据WebFrame.config中设定的数据库连接字符串，生成CDBConn实例。返回CDBConn对象。
(1) Instance()---用CBaseConfig.ConnString的数据库连接参数和预设语言名打开数据库
(CBaseConfig.ConnString在配置文件(WebFrame.xml)中设置)
(2) Instance(string ConnKey,stringLanguageName)---用ConnKey指定的数据库连接参数和LanguageName打开数据库
ConnKey=数据库连接字符串的key(在WebFrameconfig中指定的)，该key不包含语言名称。如：DB.ConnString.zh-CHS表示 ConnKey=DB.ConnString，LanguageName=zh-CHS
如果WebFrameconfig中的key值不包含语言名称，则ConnKey=WebFrameconfig中的key值。
LanguageName =使用的语言名称，主要用于多国语言(当一个语言用一个数据库时)，语言名称用.net格式(如：zh-CHT繁体版 ;zh-CHS 简体版 ;en英文版)。WebFrame.config中数据库连接字符串的key值包含该语言名称，如DB.ConnString.zh-CHS的语言名称是zh-CHS。
2 Open()
Open()---打开数据库，没有返回值。
3 Close()
Close()---关闭数据库，没有返回值。
4 IsOpen()
IsOpen()—判断数据库是否已经打开，返回值：true=是
5 BeginTrans()
BeginTrans()---开始事务处理，没有返回值。
6 CommitTrans()
CommitTrans()---提交事务处理，没有返回值。
7 RollbackTrans()
RollbackTrans()---撒消事务处理，没有返回值。
8 ExecuteNonQuery()
执行SQL语句，对于Insert,Update,Delete返回影响的数据笔数，对于其它SQL,返回-1或0，错误返回-2
? cmd=要执行的IdbCommand变量，包含参数值(请用CDbCmd类的DbCmd取得)
? strSql=要执行的完整SQL语句(如：select * from tab where id=1)。
? sql=要执行的CSqlStruct对象 (请用CEntityBuilder类的GetSqlStruct取得)
?dtVal=DataTable类型，保存cmd的参数值(一笔数据对应一个参数值，可执行多个参数值，DataTable列名与参数名相同)。
?paramValue=NameValueCollection类型，保存cmd的参数值。name=参数名(与cmd中的参数名相同),value=参数值
?xmlVal=参数保存在XML格式的字符中，格式:<r><paramNamevalue='11'/>...</r>。当只有一个参数时，xmlVal=参数值
? paramVal=object数组，保存参数值，与参数名的个数和顺序相同(cmd中的参数个数和顺序相同)。
9 ExecuteScalar()
执行SQL语句，返回第一行第一列的值。
? 参数说明请参考ExecuteNonQuery()。
10 ExecuteProcedure()
执行存储过程，结果保存在NameValueCollection类型中，name=返回参数名，value=返回参数值,失败返回null。
? procName=要执行的存储过程名，该存储过程没有参数，如果成功则返回true。
? 其它参数说明请参考ExecuteNonQuery()。
11 ExecuteProcScalar()
执行存储过程，返回第一个返回值或返回参数的值，失败返回null。
? procName=要执行的存储过程名，该存储过程没有参数，返回存储过程返回值。
? 其它参数说明请参考ExecuteNonQuery()。
12 ExecuteDataset ()
执行语句，成功返回DataSet，失败返回null。
? TableName=DataSet中的资料表名，预设是Table1。
? 其它参数说明请参考ExecuteNonQuery().
13 ExecuteReader ()
执行语句，成功返回IdataReader，失败返回null。
? 参数说明请参考ExecuteNonQuery()。
14 GetMaxValue()
取数据表指定字段的最大值，一般是取主键的最大值，成功返回取到的最大值，失败返回0
TableName=数据表名，取哪个数据表的字段。
ColName=字段名，取哪个字段的最大值，该字段必须是数字型.
CSqlDBCon类
访问 Sql server数据库类，继承CDBConn，并实现CDBConn中的方法。Client不直接使用该类。
COleDBConn类
访问 Sql server以外的其它数据库系统（同CSqlDBConn）
CEntityBuilder类
用于由SQL配置文件中产生SQL语句。该类在WebFrame.DB名字空间里
使用方法
CEntityBuilder builder=newCEntityBuilder(m_EntityFileName);
CSqlStruct sql=builder.GetSqlStruct(SqlName);
CDBConn conn=CDBConn.Instance(ConnKey,LanguageName);
conn.Open();
conn.ExecuteNonQuery(sql);
conn.Close();
函数说明
1 CEntityBuilder()
CEntityBuilder(string EntityFileName)-- 构造函数。
? EntityFileName=配置文件名，XML格式（不含路径）
2 SetEntityFile()
SetEntityFile(string EntityFileName)—设定配置文件名
? EntityFileName=配置文件名，XML格式（不含路径）
3 GetSqlStruct()
GetSqlStruct(stringSqlName)--取CSqlStruct对象，该对象的各属性的值由配置文件EntityFileName中的<sqlname=”SqlName”>决定，即用配置文件EntityFileName中的SQL名称指定的值来生成SQL语句及参数。成功返回生成的CSqlStruct对象，失败返回null.
? SqlName=要生成的SQL配置文件EntityFileName（XML格式）中的sql名称(<sql name=”SqlName”)。
七 ：asp.net通用数据库访问层源码之CEntityDAO类
CEntityDAO类
用于对数据库操作。对于单表的新增、修改、删除、查询等操作，可以直接使用该类别。该类在WebFrame.DB名字空间里
使用方法
CEntityDAO dao=newCEntityDAO(m_EntityFile,m_ConnKey,m_LanguageName,m_UseClass);
DataSet ds=dao.ExecuteDataset(sqlName);
在ASPX页面中，如果要用form的组件值作为参数值(如<input type=”text”name=”UserName”>)，该组件名(UserName)必须与参数名(即sal配置文件中的参数名，或id名,这里是UserName)相同，这时，可用以下方法取得参数值：
(1) DataSet paramDataset=new DataSet;
paramDataset.ReadXml(Request.InputStream);
(2) NameValueCollection paramValues=newNameValueCollection();
paramValues.Add(Request.Form);
paramValues.Add(Request.QueryString)
属性说明
1. LastMsg
string, 最后的错误信息。当操作发生错误时，该值包含错误原因，请将其显示出来。
2. ConnKey
string, 指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)。
3. LanguageName
string, 指定使用的语言名称。
4. UseClass
string, 指定调用该类别的类名或页面名，一般在使用该类别的函数用GetType().ToString()。
5. EntityFileName
string, 指定Sql配置文件名，不含路径。
函数说明
参数说明
以下函数的参数都是相同，其说明如下：
? SqlName=要执行的SQL名称。配置文件(在Data目录下的*.xml)中的<sqlnqme=”SqlName”>
?xmlVal=参数保存在XML格式的字符中，格式:<r><paramNamevalue='11'/>...</r>。当只有一个参数时，xmlVal=参数值
?paramValue=NameValueCollection类型，保存cmd的参数值。name=参数名(与cmd中的参数名相同),value=参数值。(对于SqlType=”Insert,Update”且replace=”1”时，可用多个值来执行多个SQL，如果某个参数的值小于最大个数，就用最后一个值，其它情况只用第一个值执行一个SQL)
? oParamVal =object数组，保存参数值，与参数名的个数和顺序相同(与cmd中的参数个数和顺序相同)。
?dtVal=DataTable类型，保存sql的参数值(一笔资料对应一个参数值)。DataTable列名必须与参数名(字段ID)相同。(对于SqlType=”Insert,Update”且replace=”1”时，可用多个值来执行多个SQL，其它情况只用第一个值执行一个SQL)
1. CEntityDAO()
CEntityDAO的构造函数。
(1)CEntityDAO()—必须用属性来指定EntityFileName，如果不指定ConnKey、LanguageName、UseClass，则使用默认值。
(2) CEntityDAO(stringentityFileName)—-指定sql配置文件名。可用属性指定ConnKey、LanguageName、UseClass，如不指定则使用默认值。
(3) CEntityDAO(string entityFileName,stringconnKey)—-指定sql配置文件及连接字符串的key，可用属性指定LanguageName、UseClass，如不指定则使用默认值。
(4) CEntityDAO(string entityFileName,string connKey,stringlanguageName)--指定sql配置文件、连接字符串的key、语言名称，可用属性指定UseClass，如不指定则使用默认值。
(5) CEntityDAO(string entityFileName,string connKey,stringlanguageName,string useClass)--指定sql配置文件、连接字符串的key、语言名称、使用的类别名。
? entityFileName=sql配置文件名，不含路径，必须要指定。
?connKey=数据库连接字符串的key值，预设使用DB.ConnString。在WebFrame.config中指定，不包含语言名称，如：<addkey="DB.ConnString.zh-CHS" value="…">中的DB.ConnString
? languageName=使用的语言名称，预设是zh-CHT。用.net格式，如zh-CHT 繁体版 ;zh-CHS 简体版;en 英文版
? useClass=使用访类别的类名。在调用该类的函数中用GetType().ToString().
2. Insert()
用SQL语句新增数据，成功返回最后新增的数据ID值，没有新增返回0，错误返回-1。
如果<sql name=’…’replace=’1’…>中的replace=”1”或”true”，则多个值来执行(拼成多个insert语句，用于同时新增字段少且数据少的数据)（如果某个值的个数小于最大个数，则用最后一个值），否则只用第一个值(用Command执行，用于新增字段多且数据多的数据)。成功返回第一个ID值(其它ID值可按第一个ID+1计算)。
?bAuto=指定是否要函数来计算主键的最大值。对于主键字段是数字(int)，且不是自动+1，该值应该为true。预设=true。
? bTrans=指定是否需要事务，true:要事务。预设=false。
3. Update()
用SQL语句修改数据，成功返回修改的数据笔数，没有修改返回0，错误返回-1
(参数与Insert()类似，请参考Insert()说明)(预设SqlName=Update)。
如果<sql name=’…’replace=’1’…>中的replace=”1”或”true”，则多个值来执行(拼成多个update语句，用于同时修改字段少且数据少的数据)（如果某个值的个数小于最大个数，则用最后一个值），否则只用第一个值(用Command执行，用于修改字段多且数据多的数据)。成功返回第一个ID值。
? bTrans=指定是否需要事务，true:要事务。预设=false。
4. ExecuteNonQuery()
执行SQL语句，成功返回执行的数据笔(int),没有结果返回0，错误返回-1。
5. ExecuteScalar()
执行SQL语句，成功第一行第一列的值(object)，失败返回null。
6. ExecuteProcedure()
执行存储过程，返回存储过程的返回值或输出参数(NameValueCollection类型，name=参数名,value=结果值)，失败返回null。
7. ExecuteProcScalar()
执行存储过程，返回存储过程的第一个返回值或输出参数(object)，失败返回null。
8. ExecuteDataset()
查找指定条件的数据(SqlType='Text'),成功返回取得的资料(DataSet),失败返回null
9. ExecuteReader()
查找指定条件的数据(SqlType='Text'),成功返回取得的资料(IDataReader),失败返回null
? conn=CDBConn类型，数据库连接对象。先用CDBConn dbConn=CDBConn.Instance();dbConn.Open();打开数据库。
10. SearchDataset()
取指定条件的数据(SqlType=”Search”)，可以只取指定页的资料(配合存储过程UPP_ExecuteForPage使用),成功返回取得的数据(DataSet),失败返回null
(1)CurrPage=int类型，指定当前页号，即取该页的数据。当用UPP_ExecuteForPage来取数据时，用CurrPage来指定取哪页的数据，当CurrPage=0时，取总资料笔数。当不使用UPP_ExecuteForPage时，CurrPage的值无效(不用该参数)
(2)PageSize=int类型，指定每页多少笔数据。当用UPP_ExecuteForPage来取数据时，用PageSize来指定取每页多少笔数据，当PageSize=0时，取全部(不分页)。当不使用UPP_ExecuteForPage时，PageSize的值无效(不用该参数)
(3)RowCount=int类型,本次查询的总记录数(先用ExecuteProcScalar()取总记录数(CurrPage=0),然后传给该参数)，如果RowCount=-1则返回2个Tables(0:取得的资料集,1:资料总数(只有一个值))。当不使用UPP_ExecuteForPage时，RowCount的值无效(不用该参数)。
11. SearchReader()
取指定条件的数据(SqlType=”Search”)，可以只取指定页的资料(配合存储过程UPP_ExecuteForPage使用),成功返回取得的数据(IDataReader),失败返回null
(参数与ExecuteProcedure()类似，请参考ExecuteProcedure()说明。)
(1) conn=CDBConn类型，数据库连接对象。先用CDBConn dbConn=CDBConn.Instance();dbConn.Open();打开数据库。
九十： asp.net通用数据库访问层源码之CRightDAO类
CRightDAO类
数据库操作基本类，在WebFrame.Base名字空间里，共有三个：CBaseDAO、CSimpleDAO、CRightDAO。所有对数据库的操作的业务逻辑层类别都继承该类。CSimpleDAO包含由ASPX页面传来的context对象，用于判断当前用户的权限，而CBaseDAO则不包括context对象，要判断权限，必须传入用户数据。一般情况下：
? 不需判断权限时，继承CBaseDAO
? 只需简单权限时，继承CSimpleDAO，该类继承CBaseDAO。
? 需要完全权限时，继承CRightDAO，该类继承CSimpleDAO。
使用方法
1.该类在WebFrame.Base名字空间里，所以必须引入WebFrame.Base才能使用。在需要对数据库操作的业务逻辑类别中继承。
2.该类预设用系统内定的数据库(由配置文件(WebFrame.config)的key=”DB.ConnString”指定)，如果要使用其它数据库，则必须指定m_ConnKey的值(配置文件(WebFrame.config)的key=”DB.ConnString”等)。建议生成一个继承该类的新类别，在构造函数中指定m_ConnKey值，在使用相同该数据库时，再继承这个新类别。
3. 如果要判断权限，则用myRight()取得权限值，然后进行判断，再执行存取数据函数。
在ASPX页面中，如果要用form的组件的值作为参数值(如<input type=”text”name=”UserName”>)，该组件名(UserName)必须与参数名(即sql配置文件中的参数名，或id名,这里是UserName)相同，这时，可用以下方法取得参数值：
(1) DataSet paramDataset=new DataSet;
paramDataset.ReadXml(Request.InputStream);
(2) NameValueCollection paramValues=newNameValueCollection();
paramValues.Add(Request.Form);
paramValues.Add(Request.QueryString)
属性说明
1. myUserId
string, myUserId=m_UserId,使用者ID。
2. myUserLevel
string, myUserLevel=m_UserLevel, 使用者（登录者）的用户(职务)级别。
3. myParentId
string, myParentId=m_ParentId,使用者所在群组的上级群组ID
4. myGroupId
string, myGroupId=m_GroupId,使用者据群组ID
5. myRoleId
string, myRoleId=m_RoleId使用者所拥有的角色ID，可有多个（用,分开）
6. myRoleLevel
string, myRoleLevel=m_RoleLevel,使用者最大角色级别。
7. LastMsg
string, LastMsg=最后信息。
8. ConnKey
string, 指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)。
9. UseClass
string, 指定调用该类别的类名或页面名，一般在使用该类别的函数用GetType().ToString()。
函数说明
1. CRightDAO ()
构造函数,一般使用CRightDAO ()。
? UserId=string, 使用者ID，必须已经解密(将Session(“UserId”)解密)。
? UserLevel= string,使用者(职务)级别。
? GroupId= string, 群组ID，必须已经解密(将Session(“GroupId”)解密)。
? ParentId= string,上级群组ID，必须已经解密(将Session(“parentId”)解密)。
2. SetEntityFile()
SetEntityFile(string fileName,stringconnKey)--设置sql配置文件，该文件是XML格式，保存SQL语句。
? fileName= string,sql配置文件名(在Data目录下的*.xml)，不包括任何路径，如my.xml
? connKey=string,指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS).
3. SetLanguage()
SetLanguage(string languageName ,stringuseClass)--设定使用的语言名称。
? languageName=使用的语言名称。
? useClass=调用该类别的类名或页面名，一般在使用该类别的函数用GetType().ToString()
4. SetContext()
SetContext()—设定页面的Context值。
5. SetUser()
SetUser(string UserId,string UserLevel)--设置使用者ID，即将使用者ID解密。
?UserId=加密的使用者ID。预设=null，表示使用Session["UserId"]，解密后保存在m_UserId中，当没有UserId(UserId=null,0)时，m_UserId=”-9”（可由属性UserId取得m_UserId的值）
?UserLevel=解密后的用户级别，如果是空，则解密登录()的用户级别(Session["UserLevel"])
6. SetGroup()
SetGroup(string GroupId,stringParentId)--设置使用者所在群组ID及上级群组ID，即将群组ID及上级群组ID解密。
?GroupId=加密的群组ID，预设=null，即使用Session["GroupId"]，解密后保存在m_GroupId中，当没有GroupId(GroupId=null,0)时，m_GroupId=”-8”（可由属性GroupId取得m_GroupId的值）
?ParentId=加密的上级群组Id，预设=null，即使用Session["ParentId"],解密后保存在m_ParentId中，当没有ParentId(ParentId=null,0)时，m_ParentId=”-7”（可由属性ParentId取得m_ParentId的值）
7. SetRole()
SetRole(string RoleId,stringRoleLevel)--设置使用者所拥有的角色ID及角色级别，即将角色ID及角色级别解密。
?RoleId=加密的角色ID，预设=null，即使用Session[RoleId"]，解密后保存在m_RoleId中，当没有RoleId(RoleId=null,0)时，m_RoleId=”-6”（可由属性RoleId取得m_RoleId的值）
?RoleLevel=角色级别，预设=null，即使用Session["RoleLevel"],解密后保存在m_RoleLevel中，当没有RoleLevel(RoleLevel=null,0)时，m_RoleLevel=”-5”（可由属性RoleLevel取得m_RoleLevel的值）。
8. myRight()
myRight(string UserId,stringSqlName)--取得使用者的操作权限。即判断该用户对该SqlName的操作权限,返回值：小于0:无权限,1-查找,2-新增,3-修改,4-删除,9-全部。
m_FullRight保存全部权限，格式：199111(6位)，每个权限一位(0无，1有)，顺序是(从左到右)1-允许,2-群组,3-角色级别,4-汇出,5-打印,6-远程。（其中，2-群组的值又有1-仅自己,2-仅群组内,3-组内及下层组，4-同级组及其下层,5-指定组,9-全部，3-角色级别的值又有1-低级别,2-同级别,9-全部）
m_right=m_FullRight中的一位，即保存m_FullRight中的一个权限。
? SqlName=SQ名称，即配置文件中的 <sqlname=”SqlName”>，系统是用SQL名来判断是否有执行该SQL的权限
? UserId=使用者ID，必须是已解密。即判断该使用者是否有执行该SQL名的权限。
? type=取权限的类别(完全权限用)，0-全部,1-允许(1-查找,2-新增,3-修改,4-删除,9-全部),2-群组(1-仅自己,2-仅群组内,3-组内及下层组，4-全部),3-级别(1-低级别,2-同级别,9-全部),4-汇出,5-打印,6-远程。预设是0，即当用myRight()时则取全部权限。
9. IsGroupRight()
IsGroupRight(string SqlName,string GroupId_UserId,bool isUser)--判断登录用户对SqlName操作的群组权限（登录用户群组与给定的群组的关系(同组、下层组，同组组)。有权限，返回>0:(1:仅自己,2:组内,3:组内及下层组,4:同级组及其下层组,9:全部)，-10:未登录,-9:无权限，0:有权限但不在组内
? SqlName=SQL名称，即配置文件中的 <sqlname=”SqlName”>，系统是用SQL名来判断是否有执行该SQL的权限。
? GroupId_UserId=要判断的群组ID，或使用者ID（判断该使用者所在的群组ID）。
? GroupId=要判断的群组ID，使用者群组与该群组的关系(同组、下层组，同组组)
?isUser=指定GroupId_UserId的值，当isUser=true时，GroupId_UserId=UserId(用该使用者ID来取得其群组ID)，否则GroupId_UserId=GroupId。
10. Insert()
新增数据，成功返回新增的数据ID，没有新增返回0，错误返回-1。
? SqlName=执行新增的SQL名称，即配置文件中的 <sqlname=”SqlName”>，预设=Insert。
?paramValues=NameValueCollection类型，保存新增的参数值,name=参数名（必须与SQL的参数名相同），value=参数值(可多个值，即允许新增多笔数据)
?dtVal=DataTable类型，保存SQL的参数值(可多个值，一笔数据一个值，即允许新增多笔数据)。当没有colHash时，DataRow列名必须与参数名相同。
?bAuto=指定是否要函数来计算主键的最大值。对于主键字段是数字(int)，且不是自动+1，该值应该为true,否则为false。预设=true。
? bTrans=指定是否需要事务，true:要事务。预设=false。
? right=指定是否要判断权限，right=true是（预设），right=false不用判断权限。
11. Update()
修改数据，成功返回修改数据笔数，没有修改返回0，错误返回-1。
(参数与Insert()类似，请参考Insert()说明)（SqlName预设=Update）
12. Delete()
删除数据，成功返回删除的数据笔数，没有删除返回0，错误返回-1。
? SqlName=执行删除的SQL名称，即配置文件中的 <sqlname=”SqlName”>，预设=Delete。
? Ids=要删除的数据ID，多个用,分开。
? bTrans=指定是否需要事务，true:要事务。预设=false。
? right=指定是否要判断权限，right=true是（预设），right=false不用判断权限。
13. IsExists()
IsExists(string SqlName,string colValue,string msgID)--判断数据是否存在(如账号、Email等不能重复的字段),讯息在LastMsg中
? SqlName=要判断的SQL名称，即配置文件中的 <sqlname=”SqlName”>，该sql格式必须是：select id from tab wherecolName=colValue。
? colValue=要判断的字段值。
? msgID=显示讯的ID(空：不显示讯息)
14. GetJSValues()
GetJSValues(string jsParamName,string SqlName,object[]paramVal)--取得指定sqlname的JS变量值，用于联动select。执行SqlName的返回字段是：上级ID，本级ID，名称
返回JS字符串，格式：
var jsParamName=new Array();jsParamName[0]=newArray("0","1","名称1");.....
? jsParamName= JS变量名，该变量在JS函数中调用。
? SqlName=要判断的SQL名称，即配置文件中的 <sqlname=”SqlName”>，该sql格式必须是：select id from tab wherecolName=colValue。
? paramVal= sql的参数值，个数和顺序必须与参数名相同。
15. isLogin()
判断是否已经登录系统，是返回true,否返回false
16. IsEdit()
IsEdit(string SqlName,SByte type)—判断是否有编辑权限，是返回true。
? SqlName=SQL名称，即配置文件中的 <sqlname=”SqlName”>，系统是用SQL名来判断是否有执行该SQL的权限。
? Type=要判断哪个权限：1-查找,2-新增,3-修改,4-删除,9-全部
17. AddMsg()
AddMsg(string msgID,bool isClear)-- 将指定讯息ID的内容加入到LastMsg中
? msgID =要加入的讯息ID，在讯息文件中
? isClear= true(预设):清除LastMsg的所有讯息
18. DispMsg()
DispMsg(string msg,string url,bool IsBack)—用JS显示讯息，并返回指定页面。
? msg =要显示的信息，如果是null或空，则显示LastMsg
? url= IsBack=false时不用。IsBack=true时，返回的页面地址，，或要执行的JS函数（以")"结束)。url=null或'':返回上一页面history.go(-1),_只有2个数字以内:返回history.go(-url)，以');'或')'结束则url=JS函数。
? IsBack=true：返回，false：不返回(留在当前页)
CSecurity类
判断使用者的操作权限类别，在WebFrame.Base名字空间里。是静态类，可以直接使用。
使用方法
该类在WebFrame.Base名字空间里，所以必须引入WebFrame.Base才能使用。可以直接使用，如CSecurity.GetRight();
属性说明
无
函数说明
1. GetSimpleRight()
GetSimpleRight(string UserId,string EntityFile,stringSqlName,string ConnKey,stringLanguageName)--取简单操作权限,即只取是否允许的权限，返回取得的权限（1有，0无）。该函数执行UP_TB_RoleRight_GetUserRight存储过程。返回：0-无权限,1-查找,2-新增,3-修改,4-删除,9-全部
? UserId=使用者ID（必须已解密），取该使用者ID的权限。
? EntityFile=sql配置文件名，不含路径
? SqlName=配置文件中的SQL名称(<sqlname=”SqlName”>)，即取UserId是否有对SqlName操作的权限。
? ConnKey=指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)。
? LanguageName=指定使用的语言名称。
2. GetRight()
取全部权限，返回取到的权限(无权限返回0)，格式：199111(6位)，每个权限一位(0无，1有)，顺序是(从左到右)1-允许,2-群组,3-角色级别,4-汇出,5-打印,6-远程。（其中，2-群组的值又有1-仅自己,2-仅群组内,3-组内及下层组，4-同级组及其下层,5-指定组,9-全部，3-角色级别的值又有1-低级别,2-同级别,9-全部）。该函数执行UP_TB_RoleRight_GetUserRight存储过程。
GetRight(string RoleIds,string EntityFile,string SqlName,stringConnKey,string LanguageName)=取指定RoleIds的SqlName的全部权限
GetRight(int right,int type) =由全部权限值取中期一个权限的值，即分解全部权限的值。
(参数与GetSimpleRight()类似，请参考GetSimpleRight()说明)
? RoleIds=角色ID，多个用,分开
? right=权限值，由GetRight(UserId,SqlName)取得的权限值。
? type=要取的权限类别，1-允许,2-群组,3-角色级别,4-汇出,5-打印,6-远程。
3. IsInGroup()
IsInGroup(string ParentId,string User_GroupId,bool bUserId,stringConnKey,stringLanguageName)--判断用户ID或群组ID是否是另一个群组内及下层组，返回值：1=User_GroupId与ParentId同组,2=User_GroupId是ParentId的直接下层，3=User_GroupId是ParentId的下层之下层,0-User_GroupId与ParentId无关系。该函数使用UP_TB_Users_IsInGroup存储过程。
? ParentId=上级群组ID，或群组ID。判断使用者的群组与ParentId的关系。
? User_GroupId=要判断的用户ID或群组ID，与ParentId中的关系。
?bUserId=指定User_GroupId的值，当bUserId=true时，User_GroupId=UserId(用该使用者ID来取得其群组ID)，否则User_GroupId=GroupId
? ConnKey=指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)
? LanguageName=指定使用的语言名称
4. IsRoleLevel()
IsUserLevel(string UserId1,string UserId2,string ConnKey,stringLanguageName)--比较操作者的级别与指定用户角色级别，返回值：-1:RoleLevel低于指定用户级别，0:相同，1:RoleLevel高于指定用户级别。该函数使用UP_TB_Role_IsRoleLevel存储过程。
? RoleLevel=角色级别，判断用户的角色级别与RoleLevel的比较。
?Role_User_GroupId=使用者的角色ID、或用户ID、或群组ID，用这些ID来取角色级别，然后与RoleLevel比较。
?nRoleId=指定Role_User_GroupId的类别，nRoleId=0时:Role_User_GroupId=RoleLevel角色级别,nRoleId=1时:Role_User_GroupId=RoleId角色ID，nRoleId=2时:Role_User_GroupId=UserId用户ID,nRoleId=3时:Role_User_GroupId=GroupId群组ID
? ConnKey=指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)
? LanguageName=指定使用的语言名称
公共属性
公共属性在CBaseConfig类别中，可以在程序中可以直接以CBaseConfig.appRoot取得)
1. appRoot
string, 应用程序物理路径（格式：c:\myDir\）
2. VirtualPath
string,应用程序虚拟路径（格式：/myWeb/）
3. EncryptKey
string,用于加密资料的密钥
4. IsCache
bool, true/false(default)从数据库中取的数据是否使用cache。
5. SqlCacheDependPath
string, 从数据库中取的数据cache依的目录(格式：c:\myDir\)
6. SmtpServer
string, 发送e-mail的SMTP服务器名称或IP地址
7. AllViewCount
int, 访问系统的总人次数。
8. DayViewCount
int, 访问系统的当日人次数。
9. AppVersion
String, WEB应用程序当前版本，格式：V版本号.年月日.时分,如V3.20050820.1403,表示版本号是3，最后更新日期是2005/8/20 14:03
10. EnablePageCache
bool, true(default)/false使用/不使用页面catch
11. PageCacheExpiresInSecond
int, 页面catch过期时长(秒,default 3600)
12. EnableSsl
bool, true/false(default)是否使用SSL加密传送数据
二： asp.net通用数据库访问层源码之公共函数
公共函数
公共方法在CBaseConfig类别中，在程序中直接以CBaseConfig.ReadStting()调用。
1. OnApplicationStart
OnApplicationStart (stringprojectDLL)---初始化CbaseConfig类，必须在Global.asax.cs的Application_Start(Objectsender, EventArgs e)中执行
projectDLL=WEB程序主DLL文件(不含路径)，该DLL在每次修改时都要变，一般是WEB项目名的DLL（用于版本计算）
2. OnApplicationEnd
OnApplicationEnd()—系统结束时，调用该函数，清除所有资源
3. AddViewCount
AddViewCount(string countKey)-- 累加计数值(访问系统的人数)。
返回累加后的总计数值(AllViewCount=总的计数值，DayViewCount=当日计数值)
countKey=在系统设定文件(AppSetting.xml)中的计数值的key。
4. RemoveAllCache
RemoveAllCache()--清除所有Cache(不清除系统使用的cache(以'PSYS_'开头))
5. ReadWebConfig
ReadWebConfig(string key, stringdefaultValue)—从WEB.Config文件中的<appSettings>中取参数值
key=web.config文件中<appkey=’’>中的key值,
defaultValue=默认值，如果没有设定则用该值。
6. ReadAppConfig
ReadAppConfig(string key, objectdefaultValue)—从系统配置文件(WebFrame.config)中读取参数值
key=<app key=’’>中的key值,defaultValue=默认值，如果没有设定则用该值
7. ReadSetting
ReadSetting(string key, objectdefaultValue)—从系统设定文件(AppSetting.xml)中读取参数值
key=<app key=’’>中的key值,defaultValue=默认值，如果没有设定则用该值
8. WriteSetting
WriteSetting(string key, stringsetting)—将key加入系统配置文件(AppSetting.xml)中(如果没有该key则生成)。(存入后，格式为：<appkey=’’ value=’’/>)，成功返回true,失败返回false
key=<app key=’’>中的key值,defaultValue=默认值，如果没有设定则用该值
9. SaveSetting
SaveSetting()—WriteSetting()并没有保存加入的key,当所有key加完后，调用该函数来保存。成功返回true,失败返回false.
10. GetMessage
GetMessage(string MsgId, stringLanguageName)—取提示信息内容，该信息放在XML文件中(该文件由配置文件(WebFrame.config)中<appSettings>中key="Web.MsgPath"的值及语言决定，文文件放在Web.MsgPath下，文件名是语言名.xml如zh-CHS.xml)
MsgId=信息ID，请参考WebFrameMsg.xml
LanguageName=使用的言语特性(不设定或为空，则使用系统设定zh-CHT),zh-CHT版 ;zh-CHS 简体版;en 英文版 ja-JP 日文版
11. CreateJSMsg
CreateJSMsg(string[] MsgIds, string LanguageName, booladdScript)--生成JS显示的讯息(从讯息文件(*.xml)中取)，这些讯息在JS函数中使用。
返回格式：<scriptlanguage='javascript'>S0001="xxx";S0002="xxx";...</script>
MsgIds=要生成的讯息ID，多个，这些讯息在讯息文件中(如zh-CHS.xml)。
LanguageName=使用的言语特性(不设定或为空，则使用系统设定zh-CHT),zh-CHT 繁体版 ;zh-CHS 简体版;en 英文版 ja-JP 日文版
addScript=true(预设):结果加上<scriptlanguage='javascript'></script>
12. ExecuteJS
ExecuteJS(string jsCodes)--执行一段JS代码。返回含<script>的jsCodes代码。
jsCodes=要执行的JS代码,必须是正确的、完整的代码,不含<scriptlanguage='javascript'>
13. ShowJsMsg
ShowJsMsg(string msg, string url, boolIsBack)—显示指定的讯息，并返回指定页面。
msg=要显示的讯息，如果为空则显示no message.
url=返回的页面url,=null或'':返回上一页面history.go(-1),只有一个数字:返回history.go(-url),以');'或')'结束:url=JS函数，其它:url=返回的页面url
IsBack= true:返回指定的url页面，false:不返回.
三： asp.net通用数据库访问层源码
1.在WEB系统的根目录下建一个存放系统配置文件的目录(如AppConfig)，设定为只读，WEB无任何权限(在IIS管理员中设定)。同时建如下子目录：
(1) data—存放SQL配置文件(如TB_Users.xml)。
(2) msg—存放系统讯息文件(如zh-CHS.xml)
(3) log—存放系统错误日志文件，必须有写入权限。
(4) setting—存放系统设定文件(如AppSetting.xml) ，必须有写入权限。
2. 设定系统配置文件(WebFrame.config)及Web.config。
3. 在Global.asax.cs文件中：
(1) 加入：using WebFrame.Config;
(2) 在Application_Start()中：
CBaseConfig.OnApplicationStart(Context.Cache,
Context.Server.MapPath(Context.Request.Application Path),
Context.Request.ApplicationPath,”project.dll”);
(3) 在Session_Start()中：
CBaseConfig.AddViewCount("App.UserCount"); //计数器+1
(4) 在Application_Error()和Application_End()中：
CBaseConfig.OnApplicationEnd();
4.
架构
WebFrame架构目前有以下几个名字空间(以后也许还会扩充)：
1.WebFrame.Base：包含CBaseDAO、CBaseDAOContext、CSecurity、CMail等类别
2.WebFrame.Config：包含CBaseConfig、CEncrypt、CWebFrameException等类别。
3. WebFrame.DB：包含所有对数据库操作的类别，请参考CDBConn.doc说明
4. WebFrame.UserServices：包含对用户数据、权限数据等操作的所有类别。
5. WebFrame.UserSimple：包含对用户数据、简单权限数据等操作的类别。
6. WebFrame.UI：包含前端页面使用的公用类别。
7. WebFrame.File：包含文件上载、下载操作的所有类别
8. WebFrame.OWC：包含用MS OWC11生成统计图的类别
其中WebFrame.Config、WebFrame.DB、WebFrame.Base是最基本、也是必须的。
使用WebFrame来开发WEB项目/项目时，至少分2层（2个项目/项目），业务逻辑层和接口层：
1.业务逻辑层：包含所有业务逻辑层的类别库（项目/项目），该类别库的所有类别都继承CBaseDAO或CBaseSimpleDAO、CRightDAO类别。类别库中至少包含WebFrame.Base、WebFrame.Config、WebFrame.DB三个名字空间，如果需要用到用户及权限数据，还必须包含WebFrame.UserSimple或 WebFrame.UserServices。
在一般应用中，业务逻辑层类别库中只需要用CEntityDAO类别来操作数据库就够了：
CEntityDAO dao=new CEntityDAO("my.xml",m_LanguageName);
DataSet ds= dao.SearchDataset("SqlName");
…………
如果CEntityDAO类别不能满足要求，或对效能要求比较高，可直接使用CDBConn类别来操作数据库：
CDBConn dbConn=CDBConn.Instance(m_ConnKey,m_LanguageName);
dbConn.Open();
dbConn.BeginTrans(); //开始事务
dbConn. ExecuteNonQuery(strSql);
…… //其它方法
dbConn.CommitTrans();
dbConn.Close();
…………
当使用CEntityDAO类别时，系统用到的所有SQL语句全部保存在XML格式的多个配置文件中(请用DBMap.exe来维护)。一个业务逻辑类用一个配置文件中（将该类用到的所有SQL全部放到一个文件中），这样有多少个业务类，就应该有多少个配置文件。SQL名称最好与类别中的方法名称相同，这样维护起来比较方便。
类别说明及详细使用方法请参考＜CDBConn.doc＞、＜CEntityDAO.doc＞、<CBaseDAO.doc>。
2.界面层：在前端接口项目/项目(WEB应用程序)中，至少包含WebFrame.Base、WebFrame.Config，其它可根据需要加入。
在接口层的ASPX或HTM页面中，存取参数值（数据表字段值）的form元素的名称必须和参数名（数据表id）相同，这样就可以用如下方法取得参数值，然后传到业务逻辑类别中：
(1) DataSet paramDataset=new DataSet;
paramDataset.ReadXml(Request.InputStream);
(2) NameValueCollection paramValues=newNameValueCollection();
paramValues.Add(Request.Form);
paramValues.Add(Request.QueryString)
CSimpleUser myCls=new CSimpleUser(); //业务逻辑层类别
myCls.SetLanguage(LanguageName); //设定使用的言语
myCls.InsertRole(paramValues); //新增角色资料
或
myCls.InsertRole(paramDataset); //新增角色资料
在WebFrame.UI中提供了一些前端接口用的公用类别，可根据情况使用或继承这些类别（也可不用），其中PageBaseDAO类别已经包含以上的paramDataset和paramValues参数，直接使用即可
四： asp.net通用数据库访问层源码之权限
权限
WebFrame包含完整的用户数据维护和权限维护功能，包括用户、群组、角色、级别，从简单到复杂的系统都能满足。注意：TB_Function表中的SqlName字段，用于设定该功能使用的SqlName(在sql配置文件中)，格式是： sql配置文件名/SqlName，多个用“,(逗号)”隔开(如：TB_User.xml/Insert,TB_Role.xml/Insert)，如果该功能只用配置文件，则只输入配置文件名(如：TB_User.xml,TB_Role.xml)。如果该功能没有对应的Sql名或配置文件名，则可指定一个唯一的名称(如1001,Users)，或功能编号(FuncNo)，在程序中用myRight(SqlName)来判断是否有权限，其中的SqlName就是TB_Function表中的SqlName字段指定的名称或编号。
根据需要，又分为简单和完全权限2种：
1.
简单权限：所有功能都放在WebFrame.UserSimple名字空间中，有3个类别(CUser,CRole,CFunction)（配置文件是TB_SimpleUser.xml,TB_SimpleUser.xml,TB_SimpleUser.xml）。没有群组和角色级别功能，一个用户只有一个角色(或当作群组)，权限只有允许(查询、新增、修改、删除)/不允许。用于对权限要求比较简单的系统。
用到的资料表有：TB_Function、TB_Role、TB_RoleRight、TB_Users等4个。
用到的存储过程有：
(1) UP_TB_RoleRight_GetRightById(共享)
(2) UP_Simple_GetMenuByFuncNo(简单权限专用)
(3) UP_Simple_GetUserRight(简单权限专用)
(4) UP_Simple_GetRoleRight(简单权限专用)
(5) UP_Simple_SetRoleRight(简单权限专用)
(6) UP_Simple_Login(简单权限专用)
(7) UP_TB_RoleRight_GetRoleRight(共享)（不用）
(8) UP_TB_Function_DelAllFuncByNo(共享)（不用）
用到的函数：UF_TB_Users_GetUserCountByGroup（公用）(可选，用于取得该群组的用户数)
2.
完全权限：具有完整的、复杂的权限控制功能，包括群组、角色级别。权限不仅有允许(1查询、2新增、3修改、4删除)/不允许，还有群组范围、角色（职务）级别控制。用于对权限要求高的系统，如OA系统、工作流等。包含在WebFrame.UserServices中的所有类别中。
使用的配置文件有：TB_code.xml、TB_function.xml、TB_group.xml、TB_role.xml、TB_user.xml。
用到的数据表（所有以TB_开头的数据表）。除包括简单权限用到的数据表外，还用到：TB_CdType、TB_Codes、TB_Group、TB_GroupInRole、TB_RoleLevel。
用到的存储过程（所有以UP_TB_开头的存储过程，但不含“简单权限专用”，共26个）。
用到的函数（所有以UF_TB_开头的函数：UF_TB_Role_GetGroupRole、UF_TB_Role_GetUserRole，UF_TB_Users_GetUserCountByGroup,共3个）。
五： asp.net通用数据库访问层源码之多语言
多语言版
WebFrame 支持多国语言显示，但必须遵守以下原则：
1.
所有需要显示多国语言的信息，都保存在XML文件中(格式参考zh-CHT.xml，在程序中用CbaseConfig.GetMessage(MsgId)取得要显示的信息)，一个语言版本保存一个XML文件，文件名用语言特性名(如繁体中文zh-CHT.xml，其它请参考CultureInfo类别说明)，并统一放在一个目录下，在配置文件(WebFrame.config)中指定该目录。(参阅WebFrame.config)。
2.
如果一个语言用一个数据库(数据库结构必须完全一样)，则数据库的ConnKey后必须加上“.言语名称”。
如“DB.ConnString.zh-CHS”或“DB.ConnString_DbType.zh-CHS”，但在指定ConnKey时，不用“.言语名称”，如只用DB.ConnString。
3.
web.config中设定使用utf-8编码，如下：
<globalization requestEncoding="utf-8"responseEncoding="utf-8" />
所有文件最好都保存为“utf-8(有签章)”的格式。
4.
在用QueryString传送中文时，必须先进行编码：
(1)
在CS中用HttpUtility.UrlEncode(string),或用Server.UrlEncode(string)来编码,(不要用HttpUtility.HtmlEncode(string)或Server.HtmlEncode(string))。
(2)
在JS中用escape(string)来编码。
(3)
在JS中接收用(string)译码，在CS中接收不用译码，直接使用，如:
string s=Request[“s”];
或string s=Request.Params[“s”] ;
5.
采用下列2种方法来实现多言语版本：
(1)
每个言语有不同的界面程序(ASPX)，并放到不同的目录中，如简体版放到 chs目录，繁体版放到cht目录，每个目录下都有一个web.config文件，用于设定该目录使用的言语(只有该行设定):
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<appSettings>
<add key="Web.Language" value="zh-CHT"/>
</appSettings>
</configuration>
在程序中用GetMessage(MsgId)取得系统显示讯息。
此方法用于不同的言语，界面程序不一样的系统。
(2)
当不同言语使用同一界面程序(ASPX)时，界面程序类(ASPX.CS)继承MultiLangPage.cs类(在WebFrame.UI中)，用LanguageName=’言语名称’来指定使用的言语(只需用一次)，然后可用LanguageName取得该用户当前使用的言语，在程序中用MultiLangPage的GetMessage(MsgId)和CreateJSMsg(MsgIds)来取得系统显示讯息(页面中，需要多言语的文字都放在讯息文件中)。在使用业务逻辑类时，必须用SetLanguage(LanguageName)来指定使用的言语。在使用CDBConn、CEntityDAO及CBaseDAO时，也要显示指定言语名称LanguageName。
6.
WebFrame只解决程序中显示信息的多国语言的问题，而要完全解决多国语言的问题，必须在设计数据库时就要考虑(可采用一种言语用一个数据库来保存，数据库结构要一样)。
global.asax.cs protected void Application_Start(Object sender,EventArgs e)
...{
CBaseConfig.OnApplicationStart("project.dll");
}
protected void Application_Error(Object sender, EventArgse)
...{
CBaseConfig.OnApplicationEnd();
}
protected void Application_End(Object sender, EventArgs e)
...{
CBaseConfig.OnApplicationEnd();
}
protected void Session_Start(Object sender, EventArgs e)
...{
CBaseConfig.AddViewCount("UserCount");//计数值
…
}
web.config
Web.config之appSettings配置说明
<system.web>
……
<!--设定上传档案最大K数(<20M)-->
<httpRuntime maxRequestLength="20000"executionTimeout="180" />
</system.web>
<appSettings>
<!—系统配置文件名(如果是物理路径，则必须有:\的符号(如c:aa.xml)，否则以网站根目录为准，但不包含根路径(如myDir\aa.xml)，预设是网站根目录下的AppConfig\WebFrame.config)-->
<add key="WebFrame.Config" value=""/>
<!--使用的言语特性(不设定或为空，则使用系统设定zh-CHT),zh-CHT 繁体版;zh-CHS 简体版 ;en 英文版 ja-JP 日文版-->
<add key="Web.Language" value="zh-CHT"/>
</appSettings>
六： asp.net通用数据库访问层源码之CDBConn类
数据库访问接口类，该类可访问不同数据库系统，使用时只调其Instance(ConnString)即可。该类在WebFrame.DB名字空间里
使用方法
属性说明
1 Connection
IdbConnection，数据库连接对象。
函数说明
1 Instance()
根据WebFrame.config中设定的数据库连接字符串，生成CDBConn实例。返回CDBConn对象。
(1) Instance()---用CBaseConfig.ConnString的数据库连接参数和预设语言名打开数据库
(CBaseConfig.ConnString在配置文件(WebFrame.xml)中设置)
(2) Instance(string ConnKey,stringLanguageName)---用ConnKey指定的数据库连接参数和LanguageName打开数据库
ConnKey=数据库连接字符串的key(在WebFrameconfig中指定的)，该key不包含语言名称。如：DB.ConnString.zh-CHS表示 ConnKey=DB.ConnString，LanguageName=zh-CHS
如果WebFrameconfig中的key值不包含语言名称，则ConnKey=WebFrameconfig中的key值。
LanguageName =使用的语言名称，主要用于多国语言(当一个语言用一个数据库时)，语言名称用.net格式(如：zh-CHT繁体版 ;zh-CHS 简体版 ;en英文版)。WebFrame.config中数据库连接字符串的key值包含该语言名称，如DB.ConnString.zh-CHS的语言名称是zh-CHS。
2 Open()
Open()---打开数据库，没有返回值。
3 Close()
Close()---关闭数据库，没有返回值。
4 IsOpen()
IsOpen()—判断数据库是否已经打开，返回值：true=是
5 BeginTrans()
BeginTrans()---开始事务处理，没有返回值。
6 CommitTrans()
CommitTrans()---提交事务处理，没有返回值。
7 RollbackTrans()
RollbackTrans()---撒消事务处理，没有返回值。
8 ExecuteNonQuery()
执行SQL语句，对于Insert,Update,Delete返回影响的数据笔数，对于其它SQL,返回-1或0，错误返回-2
? cmd=要执行的IdbCommand变量，包含参数值(请用CDbCmd类的DbCmd取得)
? strSql=要执行的完整SQL语句(如：select * from tab where id=1)。
? sql=要执行的CSqlStruct对象 (请用CEntityBuilder类的GetSqlStruct取得)
?dtVal=DataTable类型，保存cmd的参数值(一笔数据对应一个参数值，可执行多个参数值，DataTable列名与参数名相同)。
?paramValue=NameValueCollection类型，保存cmd的参数值。name=参数名(与cmd中的参数名相同),value=参数值
?xmlVal=参数保存在XML格式的字符中，格式:<r><paramNamevalue='11'/>...</r>。当只有一个参数时，xmlVal=参数值
? paramVal=object数组，保存参数值，与参数名的个数和顺序相同(cmd中的参数个数和顺序相同)。
9 ExecuteScalar()
执行SQL语句，返回第一行第一列的值。
? 参数说明请参考ExecuteNonQuery()。
10 ExecuteProcedure()
执行存储过程，结果保存在NameValueCollection类型中，name=返回参数名，value=返回参数值,失败返回null。
? procName=要执行的存储过程名，该存储过程没有参数，如果成功则返回true。
? 其它参数说明请参考ExecuteNonQuery()。
11 ExecuteProcScalar()
执行存储过程，返回第一个返回值或返回参数的值，失败返回null。
? procName=要执行的存储过程名，该存储过程没有参数，返回存储过程返回值。
? 其它参数说明请参考ExecuteNonQuery()。
12 ExecuteDataset ()
执行语句，成功返回DataSet，失败返回null。
? TableName=DataSet中的资料表名，预设是Table1。
? 其它参数说明请参考ExecuteNonQuery().
13 ExecuteReader ()
执行语句，成功返回IdataReader，失败返回null。
? 参数说明请参考ExecuteNonQuery()。
14 GetMaxValue()
取数据表指定字段的最大值，一般是取主键的最大值，成功返回取到的最大值，失败返回0
TableName=数据表名，取哪个数据表的字段。
ColName=字段名，取哪个字段的最大值，该字段必须是数字型.
CSqlDBCon类
访问 Sql server数据库类，继承CDBConn，并实现CDBConn中的方法。Client不直接使用该类。
COleDBConn类
访问 Sql server以外的其它数据库系统（同CSqlDBConn）
CEntityBuilder类
用于由SQL配置文件中产生SQL语句。该类在WebFrame.DB名字空间里
使用方法
CEntityBuilder builder=newCEntityBuilder(m_EntityFileName);
CSqlStruct sql=builder.GetSqlStruct(SqlName);
CDBConn conn=CDBConn.Instance(ConnKey,LanguageName);
conn.Open();
conn.ExecuteNonQuery(sql);
conn.Close();
函数说明
1 CEntityBuilder()
CEntityBuilder(string EntityFileName)-- 构造函数。
? EntityFileName=配置文件名，XML格式（不含路径）
2 SetEntityFile()
SetEntityFile(string EntityFileName)—设定配置文件名
? EntityFileName=配置文件名，XML格式（不含路径）
3 GetSqlStruct()
GetSqlStruct(stringSqlName)--取CSqlStruct对象，该对象的各属性的值由配置文件EntityFileName中的<sqlname=”SqlName”>决定，即用配置文件EntityFileName中的SQL名称指定的值来生成SQL语句及参数。成功返回生成的CSqlStruct对象，失败返回null.
? SqlName=要生成的SQL配置文件EntityFileName（XML格式）中的sql名称(<sql name=”SqlName”)。
七 ：asp.net通用数据库访问层源码之CEntityDAO类
CEntityDAO类
用于对数据库操作。对于单表的新增、修改、删除、查询等操作，可以直接使用该类别。该类在WebFrame.DB名字空间里
使用方法
CEntityDAO dao=newCEntityDAO(m_EntityFile,m_ConnKey,m_LanguageName,m_UseClass);
DataSet ds=dao.ExecuteDataset(sqlName);
在ASPX页面中，如果要用form的组件值作为参数值(如<input type=”text”name=”UserName”>)，该组件名(UserName)必须与参数名(即sal配置文件中的参数名，或id名,这里是UserName)相同，这时，可用以下方法取得参数值：
(1) DataSet paramDataset=new DataSet;
paramDataset.ReadXml(Request.InputStream);
(2) NameValueCollection paramValues=newNameValueCollection();
paramValues.Add(Request.Form);
paramValues.Add(Request.QueryString)
属性说明
1. LastMsg
string, 最后的错误信息。当操作发生错误时，该值包含错误原因，请将其显示出来。
2. ConnKey
string, 指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)。
3. LanguageName
string, 指定使用的语言名称。
4. UseClass
string, 指定调用该类别的类名或页面名，一般在使用该类别的函数用GetType().ToString()。
5. EntityFileName
string, 指定Sql配置文件名，不含路径。
函数说明
参数说明
以下函数的参数都是相同，其说明如下：
? SqlName=要执行的SQL名称。配置文件(在Data目录下的*.xml)中的<sqlnqme=”SqlName”>
?xmlVal=参数保存在XML格式的字符中，格式:<r><paramNamevalue='11'/>...</r>。当只有一个参数时，xmlVal=参数值
?paramValue=NameValueCollection类型，保存cmd的参数值。name=参数名(与cmd中的参数名相同),value=参数值。(对于SqlType=”Insert,Update”且replace=”1”时，可用多个值来执行多个SQL，如果某个参数的值小于最大个数，就用最后一个值，其它情况只用第一个值执行一个SQL)
? oParamVal =object数组，保存参数值，与参数名的个数和顺序相同(与cmd中的参数个数和顺序相同)。
?dtVal=DataTable类型，保存sql的参数值(一笔资料对应一个参数值)。DataTable列名必须与参数名(字段ID)相同。(对于SqlType=”Insert,Update”且replace=”1”时，可用多个值来执行多个SQL，其它情况只用第一个值执行一个SQL)
1. CEntityDAO()
CEntityDAO的构造函数。
(1)CEntityDAO()—必须用属性来指定EntityFileName，如果不指定ConnKey、LanguageName、UseClass，则使用默认值。
(2) CEntityDAO(stringentityFileName)—-指定sql配置文件名。可用属性指定ConnKey、LanguageName、UseClass，如不指定则使用默认值。
(3) CEntityDAO(string entityFileName,stringconnKey)—-指定sql配置文件及连接字符串的key，可用属性指定LanguageName、UseClass，如不指定则使用默认值。
(4) CEntityDAO(string entityFileName,string connKey,stringlanguageName)--指定sql配置文件、连接字符串的key、语言名称，可用属性指定UseClass，如不指定则使用默认值。
(5) CEntityDAO(string entityFileName,string connKey,stringlanguageName,string useClass)--指定sql配置文件、连接字符串的key、语言名称、使用的类别名。
? entityFileName=sql配置文件名，不含路径，必须要指定。
?connKey=数据库连接字符串的key值，预设使用DB.ConnString。在WebFrame.config中指定，不包含语言名称，如：<addkey="DB.ConnString.zh-CHS" value="…">中的DB.ConnString
? languageName=使用的语言名称，预设是zh-CHT。用.net格式，如zh-CHT 繁体版 ;zh-CHS 简体版;en 英文版
? useClass=使用访类别的类名。在调用该类的函数中用GetType().ToString().
2. Insert()
用SQL语句新增数据，成功返回最后新增的数据ID值，没有新增返回0，错误返回-1。
如果<sql name=’…’replace=’1’…>中的replace=”1”或”true”，则多个值来执行(拼成多个insert语句，用于同时新增字段少且数据少的数据)（如果某个值的个数小于最大个数，则用最后一个值），否则只用第一个值(用Command执行，用于新增字段多且数据多的数据)。成功返回第一个ID值(其它ID值可按第一个ID+1计算)。
?bAuto=指定是否要函数来计算主键的最大值。对于主键字段是数字(int)，且不是自动+1，该值应该为true。预设=true。
? bTrans=指定是否需要事务，true:要事务。预设=false。
3. Update()
用SQL语句修改数据，成功返回修改的数据笔数，没有修改返回0，错误返回-1
(参数与Insert()类似，请参考Insert()说明)(预设SqlName=Update)。
如果<sql name=’…’replace=’1’…>中的replace=”1”或”true”，则多个值来执行(拼成多个update语句，用于同时修改字段少且数据少的数据)（如果某个值的个数小于最大个数，则用最后一个值），否则只用第一个值(用Command执行，用于修改字段多且数据多的数据)。成功返回第一个ID值。
? bTrans=指定是否需要事务，true:要事务。预设=false。
4. ExecuteNonQuery()
执行SQL语句，成功返回执行的数据笔(int),没有结果返回0，错误返回-1。
5. ExecuteScalar()
执行SQL语句，成功第一行第一列的值(object)，失败返回null。
6. ExecuteProcedure()
执行存储过程，返回存储过程的返回值或输出参数(NameValueCollection类型，name=参数名,value=结果值)，失败返回null。
7. ExecuteProcScalar()
执行存储过程，返回存储过程的第一个返回值或输出参数(object)，失败返回null。
8. ExecuteDataset()
查找指定条件的数据(SqlType='Text'),成功返回取得的资料(DataSet),失败返回null
9. ExecuteReader()
查找指定条件的数据(SqlType='Text'),成功返回取得的资料(IDataReader),失败返回null
? conn=CDBConn类型，数据库连接对象。先用CDBConn dbConn=CDBConn.Instance();dbConn.Open();打开数据库。
10. SearchDataset()
取指定条件的数据(SqlType=”Search”)，可以只取指定页的资料(配合存储过程UPP_ExecuteForPage使用),成功返回取得的数据(DataSet),失败返回null
(1)CurrPage=int类型，指定当前页号，即取该页的数据。当用UPP_ExecuteForPage来取数据时，用CurrPage来指定取哪页的数据，当CurrPage=0时，取总资料笔数。当不使用UPP_ExecuteForPage时，CurrPage的值无效(不用该参数)
(2)PageSize=int类型，指定每页多少笔数据。当用UPP_ExecuteForPage来取数据时，用PageSize来指定取每页多少笔数据，当PageSize=0时，取全部(不分页)。当不使用UPP_ExecuteForPage时，PageSize的值无效(不用该参数)
(3)RowCount=int类型,本次查询的总记录数(先用ExecuteProcScalar()取总记录数(CurrPage=0),然后传给该参数)，如果RowCount=-1则返回2个Tables(0:取得的资料集,1:资料总数(只有一个值))。当不使用UPP_ExecuteForPage时，RowCount的值无效(不用该参数)。
11. SearchReader()
取指定条件的数据(SqlType=”Search”)，可以只取指定页的资料(配合存储过程UPP_ExecuteForPage使用),成功返回取得的数据(IDataReader),失败返回null
(参数与ExecuteProcedure()类似，请参考ExecuteProcedure()说明。)
(1) conn=CDBConn类型，数据库连接对象。先用CDBConn dbConn=CDBConn.Instance();dbConn.Open();打开数据库。
九十： asp.net通用数据库访问层源码之CRightDAO类
CRightDAO类
数据库操作基本类，在WebFrame.Base名字空间里，共有三个：CBaseDAO、CSimpleDAO、CRightDAO。所有对数据库的操作的业务逻辑层类别都继承该类。CSimpleDAO包含由ASPX页面传来的context对象，用于判断当前用户的权限，而CBaseDAO则不包括context对象，要判断权限，必须传入用户数据。一般情况下：
? 不需判断权限时，继承CBaseDAO
? 只需简单权限时，继承CSimpleDAO，该类继承CBaseDAO。
? 需要完全权限时，继承CRightDAO，该类继承CSimpleDAO。
使用方法
1.该类在WebFrame.Base名字空间里，所以必须引入WebFrame.Base才能使用。在需要对数据库操作的业务逻辑类别中继承。
2.该类预设用系统内定的数据库(由配置文件(WebFrame.config)的key=”DB.ConnString”指定)，如果要使用其它数据库，则必须指定m_ConnKey的值(配置文件(WebFrame.config)的key=”DB.ConnString”等)。建议生成一个继承该类的新类别，在构造函数中指定m_ConnKey值，在使用相同该数据库时，再继承这个新类别。
3. 如果要判断权限，则用myRight()取得权限值，然后进行判断，再执行存取数据函数。
在ASPX页面中，如果要用form的组件的值作为参数值(如<input type=”text”name=”UserName”>)，该组件名(UserName)必须与参数名(即sql配置文件中的参数名，或id名,这里是UserName)相同，这时，可用以下方法取得参数值：
(1) DataSet paramDataset=new DataSet;
paramDataset.ReadXml(Request.InputStream);
(2) NameValueCollection paramValues=newNameValueCollection();
paramValues.Add(Request.Form);
paramValues.Add(Request.QueryString)
属性说明
1. myUserId
string, myUserId=m_UserId,使用者ID。
2. myUserLevel
string, myUserLevel=m_UserLevel, 使用者（登录者）的用户(职务)级别。
3. myParentId
string, myParentId=m_ParentId,使用者所在群组的上级群组ID
4. myGroupId
string, myGroupId=m_GroupId,使用者据群组ID
5. myRoleId
string, myRoleId=m_RoleId使用者所拥有的角色ID，可有多个（用,分开）
6. myRoleLevel
string, myRoleLevel=m_RoleLevel,使用者最大角色级别。
7. LastMsg
string, LastMsg=最后信息。
8. ConnKey
string, 指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)。
9. UseClass
string, 指定调用该类别的类名或页面名，一般在使用该类别的函数用GetType().ToString()。
函数说明
1. CRightDAO ()
构造函数,一般使用CRightDAO ()。
? UserId=string, 使用者ID，必须已经解密(将Session(“UserId”)解密)。
? UserLevel= string,使用者(职务)级别。
? GroupId= string, 群组ID，必须已经解密(将Session(“GroupId”)解密)。
? ParentId= string,上级群组ID，必须已经解密(将Session(“parentId”)解密)。
2. SetEntityFile()
SetEntityFile(string fileName,stringconnKey)--设置sql配置文件，该文件是XML格式，保存SQL语句。
? fileName= string,sql配置文件名(在Data目录下的*.xml)，不包括任何路径，如my.xml
? connKey=string,指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS).
3. SetLanguage()
SetLanguage(string languageName ,stringuseClass)--设定使用的语言名称。
? languageName=使用的语言名称。
? useClass=调用该类别的类名或页面名，一般在使用该类别的函数用GetType().ToString()
4. SetContext()
SetContext()—设定页面的Context值。
5. SetUser()
SetUser(string UserId,string UserLevel)--设置使用者ID，即将使用者ID解密。
?UserId=加密的使用者ID。预设=null，表示使用Session["UserId"]，解密后保存在m_UserId中，当没有UserId(UserId=null,0)时，m_UserId=”-9”（可由属性UserId取得m_UserId的值）
?UserLevel=解密后的用户级别，如果是空，则解密登录()的用户级别(Session["UserLevel"])
6. SetGroup()
SetGroup(string GroupId,stringParentId)--设置使用者所在群组ID及上级群组ID，即将群组ID及上级群组ID解密。
?GroupId=加密的群组ID，预设=null，即使用Session["GroupId"]，解密后保存在m_GroupId中，当没有GroupId(GroupId=null,0)时，m_GroupId=”-8”（可由属性GroupId取得m_GroupId的值）
?ParentId=加密的上级群组Id，预设=null，即使用Session["ParentId"],解密后保存在m_ParentId中，当没有ParentId(ParentId=null,0)时，m_ParentId=”-7”（可由属性ParentId取得m_ParentId的值）
7. SetRole()
SetRole(string RoleId,stringRoleLevel)--设置使用者所拥有的角色ID及角色级别，即将角色ID及角色级别解密。
?RoleId=加密的角色ID，预设=null，即使用Session[RoleId"]，解密后保存在m_RoleId中，当没有RoleId(RoleId=null,0)时，m_RoleId=”-6”（可由属性RoleId取得m_RoleId的值）
?RoleLevel=角色级别，预设=null，即使用Session["RoleLevel"],解密后保存在m_RoleLevel中，当没有RoleLevel(RoleLevel=null,0)时，m_RoleLevel=”-5”（可由属性RoleLevel取得m_RoleLevel的值）。
8. myRight()
myRight(string UserId,stringSqlName)--取得使用者的操作权限。即判断该用户对该SqlName的操作权限,返回值：小于0:无权限,1-查找,2-新增,3-修改,4-删除,9-全部。
m_FullRight保存全部权限，格式：199111(6位)，每个权限一位(0无，1有)，顺序是(从左到右)1-允许,2-群组,3-角色级别,4-汇出,5-打印,6-远程。（其中，2-群组的值又有1-仅自己,2-仅群组内,3-组内及下层组，4-同级组及其下层,5-指定组,9-全部，3-角色级别的值又有1-低级别,2-同级别,9-全部）
m_right=m_FullRight中的一位，即保存m_FullRight中的一个权限。
? SqlName=SQ名称，即配置文件中的 <sqlname=”SqlName”>，系统是用SQL名来判断是否有执行该SQL的权限
? UserId=使用者ID，必须是已解密。即判断该使用者是否有执行该SQL名的权限。
? type=取权限的类别(完全权限用)，0-全部,1-允许(1-查找,2-新增,3-修改,4-删除,9-全部),2-群组(1-仅自己,2-仅群组内,3-组内及下层组，4-全部),3-级别(1-低级别,2-同级别,9-全部),4-汇出,5-打印,6-远程。预设是0，即当用myRight()时则取全部权限。
9. IsGroupRight()
IsGroupRight(string SqlName,string GroupId_UserId,bool isUser)--判断登录用户对SqlName操作的群组权限（登录用户群组与给定的群组的关系(同组、下层组，同组组)。有权限，返回>0:(1:仅自己,2:组内,3:组内及下层组,4:同级组及其下层组,9:全部)，-10:未登录,-9:无权限，0:有权限但不在组内
? SqlName=SQL名称，即配置文件中的 <sqlname=”SqlName”>，系统是用SQL名来判断是否有执行该SQL的权限。
? GroupId_UserId=要判断的群组ID，或使用者ID（判断该使用者所在的群组ID）。
? GroupId=要判断的群组ID，使用者群组与该群组的关系(同组、下层组，同组组)
?isUser=指定GroupId_UserId的值，当isUser=true时，GroupId_UserId=UserId(用该使用者ID来取得其群组ID)，否则GroupId_UserId=GroupId。
10. Insert()
新增数据，成功返回新增的数据ID，没有新增返回0，错误返回-1。
? SqlName=执行新增的SQL名称，即配置文件中的 <sqlname=”SqlName”>，预设=Insert。
?paramValues=NameValueCollection类型，保存新增的参数值,name=参数名（必须与SQL的参数名相同），value=参数值(可多个值，即允许新增多笔数据)
?dtVal=DataTable类型，保存SQL的参数值(可多个值，一笔数据一个值，即允许新增多笔数据)。当没有colHash时，DataRow列名必须与参数名相同。
?bAuto=指定是否要函数来计算主键的最大值。对于主键字段是数字(int)，且不是自动+1，该值应该为true,否则为false。预设=true。
? bTrans=指定是否需要事务，true:要事务。预设=false。
? right=指定是否要判断权限，right=true是（预设），right=false不用判断权限。
11. Update()
修改数据，成功返回修改数据笔数，没有修改返回0，错误返回-1。
(参数与Insert()类似，请参考Insert()说明)（SqlName预设=Update）
12. Delete()
删除数据，成功返回删除的数据笔数，没有删除返回0，错误返回-1。
? SqlName=执行删除的SQL名称，即配置文件中的 <sqlname=”SqlName”>，预设=Delete。
? Ids=要删除的数据ID，多个用,分开。
? bTrans=指定是否需要事务，true:要事务。预设=false。
? right=指定是否要判断权限，right=true是（预设），right=false不用判断权限。
13. IsExists()
IsExists(string SqlName,string colValue,string msgID)--判断数据是否存在(如账号、Email等不能重复的字段),讯息在LastMsg中
? SqlName=要判断的SQL名称，即配置文件中的 <sqlname=”SqlName”>，该sql格式必须是：select id from tab wherecolName=colValue。
? colValue=要判断的字段值。
? msgID=显示讯的ID(空：不显示讯息)
14. GetJSValues()
GetJSValues(string jsParamName,string SqlName,object[]paramVal)--取得指定sqlname的JS变量值，用于联动select。执行SqlName的返回字段是：上级ID，本级ID，名称
返回JS字符串，格式：
var jsParamName=new Array();jsParamName[0]=newArray("0","1","名称1");.....
? jsParamName= JS变量名，该变量在JS函数中调用。
? SqlName=要判断的SQL名称，即配置文件中的 <sqlname=”SqlName”>，该sql格式必须是：select id from tab wherecolName=colValue。
? paramVal= sql的参数值，个数和顺序必须与参数名相同。
15. isLogin()
判断是否已经登录系统，是返回true,否返回false
16. IsEdit()
IsEdit(string SqlName,SByte type)—判断是否有编辑权限，是返回true。
? SqlName=SQL名称，即配置文件中的 <sqlname=”SqlName”>，系统是用SQL名来判断是否有执行该SQL的权限。
? Type=要判断哪个权限：1-查找,2-新增,3-修改,4-删除,9-全部
17. AddMsg()
AddMsg(string msgID,bool isClear)-- 将指定讯息ID的内容加入到LastMsg中
? msgID =要加入的讯息ID，在讯息文件中
? isClear= true(预设):清除LastMsg的所有讯息
18. DispMsg()
DispMsg(string msg,string url,bool IsBack)—用JS显示讯息，并返回指定页面。
? msg =要显示的信息，如果是null或空，则显示LastMsg
? url= IsBack=false时不用。IsBack=true时，返回的页面地址，，或要执行的JS函数（以")"结束)。url=null或'':返回上一页面history.go(-1),_只有2个数字以内:返回history.go(-url)，以');'或')'结束则url=JS函数。
? IsBack=true：返回，false：不返回(留在当前页)
CSecurity类
判断使用者的操作权限类别，在WebFrame.Base名字空间里。是静态类，可以直接使用。
使用方法
该类在WebFrame.Base名字空间里，所以必须引入WebFrame.Base才能使用。可以直接使用，如CSecurity.GetRight();
属性说明
无
函数说明
1. GetSimpleRight()
GetSimpleRight(string UserId,string EntityFile,stringSqlName,string ConnKey,stringLanguageName)--取简单操作权限,即只取是否允许的权限，返回取得的权限（1有，0无）。该函数执行UP_TB_RoleRight_GetUserRight存储过程。返回：0-无权限,1-查找,2-新增,3-修改,4-删除,9-全部
? UserId=使用者ID（必须已解密），取该使用者ID的权限。
? EntityFile=sql配置文件名，不含路径
? SqlName=配置文件中的SQL名称(<sqlname=”SqlName”>)，即取UserId是否有对SqlName操作的权限。
? ConnKey=指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)。
? LanguageName=指定使用的语言名称。
2. GetRight()
取全部权限，返回取到的权限(无权限返回0)，格式：199111(6位)，每个权限一位(0无，1有)，顺序是(从左到右)1-允许,2-群组,3-角色级别,4-汇出,5-打印,6-远程。（其中，2-群组的值又有1-仅自己,2-仅群组内,3-组内及下层组，4-同级组及其下层,5-指定组,9-全部，3-角色级别的值又有1-低级别,2-同级别,9-全部）。该函数执行UP_TB_RoleRight_GetUserRight存储过程。
GetRight(string RoleIds,string EntityFile,string SqlName,stringConnKey,string LanguageName)=取指定RoleIds的SqlName的全部权限
GetRight(int right,int type) =由全部权限值取中期一个权限的值，即分解全部权限的值。
(参数与GetSimpleRight()类似，请参考GetSimpleRight()说明)
? RoleIds=角色ID，多个用,分开
? right=权限值，由GetRight(UserId,SqlName)取得的权限值。
? type=要取的权限类别，1-允许,2-群组,3-角色级别,4-汇出,5-打印,6-远程。
3. IsInGroup()
IsInGroup(string ParentId,string User_GroupId,bool bUserId,stringConnKey,stringLanguageName)--判断用户ID或群组ID是否是另一个群组内及下层组，返回值：1=User_GroupId与ParentId同组,2=User_GroupId是ParentId的直接下层，3=User_GroupId是ParentId的下层之下层,0-User_GroupId与ParentId无关系。该函数使用UP_TB_Users_IsInGroup存储过程。
? ParentId=上级群组ID，或群组ID。判断使用者的群组与ParentId的关系。
? User_GroupId=要判断的用户ID或群组ID，与ParentId中的关系。
?bUserId=指定User_GroupId的值，当bUserId=true时，User_GroupId=UserId(用该使用者ID来取得其群组ID)，否则User_GroupId=GroupId
? ConnKey=指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)
? LanguageName=指定使用的语言名称
4. IsRoleLevel()
IsUserLevel(string UserId1,string UserId2,string ConnKey,stringLanguageName)--比较操作者的级别与指定用户角色级别，返回值：-1:RoleLevel低于指定用户级别，0:相同，1:RoleLevel高于指定用户级别。该函数使用UP_TB_Role_IsRoleLevel存储过程。
? RoleLevel=角色级别，判断用户的角色级别与RoleLevel的比较。
?Role_User_GroupId=使用者的角色ID、或用户ID、或群组ID，用这些ID来取角色级别，然后与RoleLevel比较。
?nRoleId=指定Role_User_GroupId的类别，nRoleId=0时:Role_User_GroupId=RoleLevel角色级别,nRoleId=1时:Role_User_GroupId=RoleId角色ID，nRoleId=2时:Role_User_GroupId=UserId用户ID,nRoleId=3时:Role_User_GroupId=GroupId群组ID
? ConnKey=指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的
<addkey=”DB.ConnString.zh-CHS”…/>中指定(不包含语言名称.zh-CHS)
? LanguageName=指定使用的语言名称
