CYQ.Data 轻量数据层之路 使用篇五曲 MProc 存储过程与SQL(十六)

上一篇：CYQ.Data 轻量数据层之路 使用篇四曲 MAction 增删改(十五)

本篇内容概要

本篇继续上一篇内容，本节介绍MProc 类的相关操作。
1：MProc 存储过程操作
2：MProc SQL执行操作[将于V1.5版本以上支持]

一：构造函数

方法原型：
public MProc(object procNamesEnum)
public MProc(object procName, string conn)

说明：

构造函数和MAction用法一致，相关操作可参数MAction。

示例1：

//传入存储过程名称 默认取配置项Conn的数据库链接
MProc proc = new MProc("GetUserList");
MProc proc = new MProc(ProcNames.GetUserList);//通过枚举传入

示例2：

//传入数据库新的数据库链接 配置项Conn
MProc proc = new MProc("GetUserList","ChatConn");
//传入数据库新的数据库链接 直接链接字符串
MProc proc = new MProc("GetUserList","Server=.;database=Chat;uid=sa;pwd=xxxxx");
//多数据库下用约定名称 取自ChatConn配置项的链接
MProc proc = new MProc(P_ChatEnum.GetUserList);

示例3：

说明：仅在V1.5版本以上支持。
//执行自定义SQL 语句 默认取自Conn配置项数据库链接
MProc proc = new MProc("select * from Users");
//执行自定义SQL 语句 取自ChatConn配置项数据库链接
MProc proc = new MProc("select * from Users","ChatConn");

二：参数操作

方法原型：

public void Set(object paraName, object value)
public void Set(object paraName, object value,SqlDbType sqlDbType)
public void Clear()

示例1：

//为存储过程或参数化SQL语句的设置参数
proc.Set("ID", 888);//不加@，内部自加
proc.Set("@ID", 888);
proc.Set(GetUserList.ID, 888);//枚举方式传递

示例2：

proc.Set(Users.ID, 888,SqlDbType.Int);//比上个示例多加了个参数。

示例3：

proc.Clear();//清除所有Set的参数。

三：方法操作

方法原型：

public MDataTable ExeMDataTable()
public int ExeNonQuery()
public T ExeScalar<T>()

示例1：

MDataTable table = proc.ExeMDataTable();//执行返回MDataTable

示例2：

int result = proc.ExeNonQuery();//添加、更新、删除操作，返回受影响的行数。

示例3：

string result = proc.ExeScalar<string>();//执行语句，返回首行首列的值。

四：返回值与链接关闭

方法原型：
public int ReturnValue
public void Close()

示例1：

MDataTable table= proc.ExeMDataTable();
int value = proc.ReturnValue;//执行的如果是存储过程，取返回值，通过是记录总数。

示例：

MProc proc = new MProc("GetUserList");
MDataTable table= proc.ExeMDataTable();
int value = proc.ReturnValue;
proc.Close();//执行完后关闭数据库链接

五：一个完整示例

示例：

使用示例：
实例化：  MProc proc = new MProc(ProcNames.GetList);
添加参数：proc.Set(GetList.ID, 10);
获取列表：MDataTable table = proc.ExeMDataTable();
取返回值：int count=proc.ReturnValue;
关闭链接：proc.Close();
绑定控件：GridView1.DataSource = table;
         GridView1.DataBind();

结言：

通过本节介绍，掌握使用MProc处理存储过程操作。
一些特别的自定的SQL语句操作也可以操作[需要V1.5及以上版本支持]。

本使用篇教程到此结束，下面紧跟着会开源V1.4版本，敬请关注。

同时若引起起相关教程需要升级，会续篇介绍。