MyDAL

索引：

目录索引

一.安装

　　在 VS 中执行一下 package 命令:　　

PM> Install-Package MyDAL

二.API-快速使用

　　1.命名空间,只需:

using MyDAL;

　　2.准备好一个 XConnection 对象,目前支持 MySQL / SQL Server ,后续会支持  Oracle / Postgre SQL ... 等等:

　　　　以 MySQL 为例，如下：

//
// Nuget : Package : MySql.Data
//
// 不同版本 mysql 连接字符串一般如下：
// "Server=localhost; Database=MyDAL_TestDB; Uid=SkyUser; Pwd=Sky@4321;"
// "Server=localhost; Database=MyDAL_TestDB; Uid=SkyUser; Pwd=Sky@4321;SslMode=none;"
// "Server=localhost; Database=MyDAL_TestDB; Uid=SkyUser; Pwd=Sky@4321;SslMode=none;allowPublicKeyRetrieval=true;"
//
var Conn = 
  new XConnection
   (
     new MySqlConnection
       ("Server=localhost; Database=MyDAL_TestDB; Uid=SkyUser; Pwd=Sky@4321;SslMode=none;allowPublicKeyRetrieval=true;")
    );

　　3.新增一条数据:

            var pk = Guid.Parse("8f2cbb64-8356-4482-88ee-016558c05b2d");
            var m15 = new AlipayPaymentRecord
            {
                Id = pk,
                CreatedOn = DateTime.Parse("2018-08-20 19:12:05.933786"),
                PaymentRecordId = Guid.Parse("e94f747e-1a6d-4be6-af51-016558c05b29"),
                OrderId = Guid.Parse("f60f08e7-9678-41a8-b4aa-016558c05afc"),
                TotalAmount = 0.010000000000000000000000000000M,
                Description = null,
                PaymentSN = "2018082021001004180510465833",
                PayedOn = DateTime.Parse("2018-08-20 20:36:35.720525"),
                CanceledOn = null,
                PaymentUrl = "https://openapi.xxx?charset=UTF-8&app_id=zzz&version=1.0"
            };

            // 新增一条数据: AlipayPaymentRecord
            var res15 = await Conn.CreateAsync(m15);

　　　　以 MySQL 为例，生成 SQL 如下：

insert into `AlipayPaymentRecord` 
(`Id`,`CreatedOn`,`PaymentRecordId`,`OrderId`,`TotalAmount`,`Description`,`PaymentSN`,`PayedOn`,`CanceledOn`,`PaymentUrl`)
values 
(?Id_2,?CreatedOn_3,?PaymentRecordId_4,?OrderId_5,?TotalAmount_6,
5  ?Description_7,?PaymentSN_8,?PayedOn_9,?CanceledOn_10,?PaymentUrl_11);

 　　4.删除一条数据:

            var pk = Guid.Parse("8f2cbb64-8356-4482-88ee-016558c05b2d");

            // 删除一条数据: AlipayPaymentRecord
            await Conn.DeleteAsync<AlipayPaymentRecord>(it=>it.Id==pk);

　　　　以 MySQL 为例，生成 SQL 如下：

delete
from `AlipayPaymentRecord`
where  `Id`=?Id_1;

　　5.修改一条数据:

            var pk1 = Guid.Parse("8f2cbb64-8356-4482-88ee-016558c05b2d");

            // 修改一条数据: AlipayPaymentRecord
            var res1 = await Conn.UpdateAsync<AlipayPaymentRecord>(it=>it.Id==pk1, new    //  where 条件: it=>it.Id==pk1
            {
                Description = "new desc",    // 修改 AlipayPaymentRecord 字段 Description 的值为: "new desc"
                PaymentUrl = "new url"    //  修改 AlipayPaymentRecord 字段 PaymentUrl 的值为: "new url"
            });

　　　　以 MySQL 为例，生成 SQL 如下：

update `AlipayPaymentRecord`
set `Description`=?Description_1,
    `PaymentUrl`=?PaymentUrl_2
where  `Id`=?Id_3;

　　6.单表 查询一条数据:

            var pk1 = Guid.Parse("8f2cbb64-8356-4482-88ee-016558c05b2d");

            // 查询一条数据: AlipayPaymentRecord
            var res11 = await Conn.QueryOneAsync<AlipayPaymentRecord>(it=>it.Id==pk1);

　　　　以 MySQL 为例，生成 SQL 如下：

select *
from `AlipayPaymentRecord`
where  `Id`=?Id_1
limit 0,1;

　　7.多表连接 查询一组数据:　　

            var res4 = await Conn
                .Queryer(out AspnetUsers user4, out AspnetUserRoles userRole4, out AspnetRoles role4)
                .From(() => user4)
                    .InnerJoin(() => userRole4)
                        .On(() => user4.Id == userRole4.UserId)
                    .InnerJoin(() => role4)
                        .On(() => userRole4.RoleId == role4.Id)
                .Where(() => user4.NickName.StartsWith("刘"))
                .OrderBy(() => user4.UserName)
                    .ThenOrderBy(() => user4.AgentLevel, OrderByEnum.Asc)
                .QueryListAsync<AspnetUsers>();

　　　　以 MySQL 为例，生成 SQL 如下：

select user4.`*`
from `AspNetUsers` as user4 
    inner join AspNetUserRoles as userRole4
        on user4.`Id`=userRole4.`UserId`
    inner join AspNetRoles as role4
        on userRole4.`RoleId`=role4.`Id`
where  user4.`NickName` like  ?NickName_6
order by user4.`UserName`  desc ,user4.`AgentLevel`  asc ;

　　8.与表对应的 Model 如下:　　

    /*
     * CREATE TABLE `alipaypaymentrecord` (
     *  `Id` char(36) NOT NULL,
     *  `CreatedOn` datetime(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6),
     *  `PaymentRecordId` char(36) NOT NULL,
     *  `OrderId` char(36) NOT NULL,
     *  `TotalAmount` decimal(65,30) NOT NULL,
     *  `Description` longtext,
     *  `PaymentSN` longtext,
     *  `PayedOn` datetime(6) DEFAULT NULL,
     *  `CanceledOn` datetime(6) DEFAULT NULL,
     *  `PaymentUrl` longtext,
     *  PRIMARY KEY (`Id`)
     *) ENGINE=InnoDB DEFAULT CHARSET=utf8
     */
    [XTable(Name = "AlipayPaymentRecord")]     // XTableAttribute 指明 该 Model 对应 DB 中的 table 名.
    public class AlipayPaymentRecord
    {
        public Guid Id { get; set; }
        public DateTime CreatedOn { get; set; }
        public Guid PaymentRecordId { get; set; }
        public Guid OrderId { get; set; }
        public decimal TotalAmount { get; set; }
        public string Description { get; set; }
        public string PaymentSN { get; set; }
        public DateTime? PayedOn { get; set; }
        public DateTime? CanceledOn { get; set; }
        public string PaymentUrl { get; set; }
    }

　　9.快速查看 语句 对应生成的 SQL,如下:

　　　　在 VS 输出 窗口 可以看到 语句执行前 对应 生成 的 参数化 SQL 例如 -- 新增如下：

如果你喜欢这个平台框架,别忘了在 Github 上给点个 Star(星) 啊~~

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　蒙

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2018-10-22 18:30 周一

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2018-11-18 16:53 周日

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2018-12-27 21:30 周四

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2019-02-07 23:55 周四

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2019-02-24 17:38 周日

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2019-04-12 17:56 周五

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2019-05-05 15:38 周日

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　2019-05-20 17:50 周一