用于对数据库操作对于单表的新增.doc

CEntityDAO类用于对数据库操作。对于单表的新增、修改、删除、查询等操作，可以直接使用该类别。该类在WebFrame.DB名字空间里使用方法CEntityDAO dao=new CEntityDAO(m_EntityFile,m_ConnKey,m_LanguageName,m_UseClass);DataSet ds=dao.ExecuteDataset(sqlName);在ASPX页面中，如果要用form的组件值作为参数值(如)，该组件名(UserName)必须与参数名(即sal配置文件中的参数名，或id名,这里是UserName)相同，这时，可用以下方法取得参数值：(1) DataSet paramDataset=new DataSet; paramDataset.ReadXml(Request.InputStream);(2) NameValueCollection paramValues=new NameValueCollection();paramValues.Add(Request.Form);paramValues.Add(Request.QueryString)属性说明1. LastMsgstring, 最后的错误信息。当操作发生错误时，该值包含错误原因，请将其显示出来。2. ConnKeystring, 指定数据库连接字符串的key，该值在系统配置文件(WebFrame.config)中的中指定(不包含语言名称.zh-CHS)。3. LanguageNamestring, 指定使用的语言名称。4. UseClassstring, 指定调用该类别的类名或页面名，一般在使用该类别的函数用GetType().ToString()。5. EntityFileNamestring, 指定Sql配置文件名，不含路径。函数说明参数说明以下函数的参数都是相同，其说明如下：l SqlName=要执行的SQL名称。配置文件(在Data目录下的*.xml)中的l xmlVal=参数保存在XML格式的字符中，格式:.。当只有一个参数时，xmlVal=参数值l paramValue=NameValueCollection类型，保存cmd的参数值。name=参数名(与cmd中的参数名相同),value=参数值。(对于SqlType=”Insert,Update”且replace=”1”时，可用多个值来执行多个SQL，如果某个参数的值小于最大个数，就用最后一个值，其它情况只用第一个值执行一个SQL)l oParamVal =object数组，保存参数值，与参数名的个数和顺序相同(与cmd中的参数个数和顺序相同)。l dtVal=DataTable类型，保存sql的参数值(一笔资料对应一个参数值)。DataTable列名必须与参数名(字段ID)相同。(对于SqlType=”Insert,Update”且replace=”1”时，可用多个值来执行多个SQL，其它情况只用第一个值执行一个SQL)1. CEntityDAO()CEntityDAO的构造函数。(1) CEntityDAO()必须用属性来指定EntityFileName，如果不指定ConnKey、LanguageName、UseClass，则使用默认值。(2) CEntityDAO(string entityFileName)-指定sql配置文件名。可用属性指定ConnKey、LanguageName、UseClass，如不指定则使用默认值。(3) CEntityDAO(string entityFileName,string connKey)-指定sql配置文件及连接字符串的key，可用属性指定LanguageName、UseClass，如不指定则使用默认值。(4) CEntityDAO(string entityFileName,string connKey,string languageName)- 指定sql配置文件、连接字符串的key、语言名称，可用属性指定UseClass，如不指定则使用默认值。(5) CEntityDAO(string entityFileName,string connKey,string languageName,string useClass)- 指定sql配置文件、连接字符串的key、语言名称、使用的类别名。 entityFileName=sql配置文件名，不含路径，必须要指定。 connKey=数据库连接字符串的key值，预设使用DB.ConnString。在WebFrame.config中指定，不包含语言名称，如：中的 DB.ConnString languageName=使用的语言名称，预设是zh-CHT。用.net格式，如zh-CHT 繁体版 ;zh-CHS 简体版 ;en 英文版 useClass=使用访类别的类名。在调用该类的函数中用GetType().ToString().2. Insert()用SQL语句新增数据，成功返回最后新增的数据ID值，没有新增返回0，错误返回-1。如果中的replace=”1”或”true”，则多个值来执行(拼成多个insert语句，用于同时新增字段少且数据少的数据)（如果某个值的个数小于最大个数，则用最后一个值），否则只用第一个值(用Command执行，用于新增字段多且数据多的数据)。成功返回第一个ID值(其它ID值可按第一个ID+1计算)。l bAuto=指定是否要函数来计算主键的最大值。对于主键字段是数字(int)，且不是自动+1，该值应该为true。预设=true。l bTrans=指定是否需要事务，true:要事务。预设=false。3. Update()用SQL语句修改数据，成功返回修改的数据笔数，没有修改返回0，错误返回-1(参数与Insert()类似，请参考Insert()说明)(预设SqlName=Update)。如果中的replace=”1”或”true”，则多个值来执行(拼成多个update语句，用于同时修改字段少且数据少的数据)（如果某个值的个数小于最大个数，则用最后一个值），否则只用第一个值(用Command执行，用于修改字段多且数据多的数据)。成功返回第一个ID值。l 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),失败返回null9. ExecuteReader()查找指定条件的数据(SqlType=Text),成功返回取得的资料(IDataReader),失败返回nulll 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”)，可以只取指定