目录
1.Dapper 简介
2.Dapper 安装
3.Dapper 使用
Dapper简介
Dapper是一个轻量级的ORM框架,短小精悍,正如其名。对于小项目,使用EF,NHibernate这样的重量级ORM框架,有点杀鸡用牛刀的感觉,此时Dapper会是个很不错的选择。
Dapper优势
- 轻量,Dapper.dll大小不到105KB。
- 快,读取数据接近IDataReader。
- 支持大部分主流的数据库,如:MS SQL,Oracle,MySQL,Sqlite等等。
- 支持映射一对一,一对多,多对多关系。
Dapper原理
Dapper实际上是扩展了IDbConnection,提供了一些的查询和执行方法,对ADO.NET的访问对象进行了最底层的封装,所以性能接近ADO.NET。
Dapper安装
通过NuGet包管理器,直接搜索Dapper,选择搜索结果中的第一个,点击安装到项目中即可。
Dapper 使用
Dapper查询结果支持强类型,同时也支持动态类型,在实际开发中我们建议使用强类型,方便以后维护。
实体类
示例中需要用到两个实体类型,分别为Post.cs和User.cs。
public class Post
{
public int Id { get; set; }
public string Title { get; set; }
public string Content { get; set; }
public User User { get; set; }
} public class User
{
public int Id { get; set; }
public string Name { get; set; }
}
创建表脚本:
CREATE TABLE [dbo].[Post](
[Id] [int] IDENTITY(,) NOT NULL,
[Title] [nvarchar]() NULL,
[Content] [nvarchar]() NULL,
[UserId] [int] NULL,
CONSTRAINT [PK_Post] PRIMARY KEY CLUSTERED
(
[Id] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY] CREATE TABLE [dbo].[User](
[Id] [int] IDENTITY(,) NOT NULL,
[Name] [nvarchar]() NULL,
PRIMARY KEY CLUSTERED
(
[Id] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY]
辅助类
由于Dapper是IDbConnection.cs进行了扩展,所以我们自己要管理数据库连接,本示例我封装了一个简单的DBHelper.cs用于管理数据库连接的打开和关闭。
public class DBHelper
{
private static string strConn = "Data Source=2012-20130731KI;Initial Catalog=QYHDB;Integrated Security=True;Connect Timeout=15;Encrypt=False;TrustServerCertificate=False"; /// <summary>
/// 打开链接
/// </summary>
public static SqlConnection OpenConnection()
{
SqlConnection conn = new SqlConnection(strConn);
conn.Open(); return conn;
} public static void CloseConnection()
{
SqlConnection conn = new SqlConnection(strConn);
if (conn.State != System.Data.ConnectionState.Closed)
{
conn.Close();
}
} }
方法测试
/// <summary>
/// Dapper示例
/// </summary>
class Program
{
static void Main(string[] args)
{
SqlConnection conn = DBHelper.OpenConnection(); //示例1:简单查询,返回强类型列表
Console.WriteLine("示例1:简单查询,返回强类型列表:");
var result1 = conn.Query<Post>("select Id,Title,Content from Post");
foreach (var item in result1)
{
Console.WriteLine(item.Id + " " + item.Title + " " + item.Content);
} //示例2:简单查询,返回动态列表
Console.WriteLine("示例2:简单查询,返回动态列表");
var result2 = conn.Query("select Id,Title,Content from Post");
foreach (var item in result1)
{
Console.WriteLine(item.Id + " " + item.Title + " " + item.Content);
} //示例3:带参数的查询
Console.WriteLine("示例3:带参数的查询");
var result3 = conn.Query<Post>("select Id,Title,Content from Post where UserId=@UserId", new { UserId = });
foreach (var item in result3)
{
Console.WriteLine(item.Id + " " + item.Title + " " + item.Content);
} //示例4:执行没有返回结果的命名
//Test04(conn); //示例5:执行多次脚本
//Console.WriteLine("示例5:执行多次脚本");
//conn.Execute("insert into [User](Name) values(@Name)", new[] { new { Name = "wangwu" }, new { Name = "zhouliu" }, new { Name = "chenqi" } }); ////示例6:返回多个结果
Console.WriteLine("示例6:返回多个结果");
string sql = @"select * from Post where Id=@Id
select * from [User] where Id=@Id"; using (var multi = conn.QueryMultiple(sql, new { Id = }))
{
Post post = multi.Read<Post>().Single();
User user = multi.Read<User>().Single();
} //示例7:执行存储过程
Console.WriteLine("示例7:执行存储过程");
var result7 = conn.Query<Post>("sp_GetPost", new { Id = }, commandType: CommandType.StoredProcedure);
foreach (var item in result7)
{
Console.WriteLine(item.Id + " " + item.Title + " " + item.Content);
} // 示例8:一对多映射,返回的一行数据映射到数据库多张表
Console.WriteLine("示例8:一对多映射");
string sqlOneToMulti = "select * from Post p inner join [User] u on p.UserId=u.Id"; //Query<TFirst, TSecond, TReturn>
var data = conn.Query<Post, User, Post>(sqlOneToMulti, (post, user) => { post.User = user; return post; }); DBHelper.CloseConnection(); Console.Read();
}
}