目錄

1.Dapper 簡介

2.Dapper 安裝

3.Dapper 使用

Dapper簡介　　

         Dapper是一個輕量級的ORM框架，短小精悍，正如其名。對於小專案，使用EF,NHibernate這樣的重量級ORM框架，有點殺雞用牛刀的感覺，此時Dapper會是個很不錯的選擇。 

Dapper優勢　　

1. 輕量，Dapper.dll大小不到105KB。
2. 快，讀取資料接近IDataReader。
3. 支援大部分主流的資料庫，如：MS SQL，Oracle，MySQL，Sqlite等等。
4. 支援對映一對一，一對多，多對多關係。 

Dapper原理

　　Dapper實際上是擴充套件了IDbConnection，提供了一些的查詢和執行方法，對ADO.NET的訪問物件進行了最底層的封裝，所以效能接近ADO.NET。 

Dapper安裝　　

　　通過NuGet包管理器，直接搜尋Dapper，選擇搜尋結果中的第一個，點選安裝到專案中即可。

Dapper 使用

　　Dapper查詢結果支援強型別，同時也支援動態型別，在實際開發中我們建議使用強型別，方便以後維護。 

實體類　　

　　示例中需要用到兩個實體型別，分別為Post.cs和User.cs。　　

　　建立表指令碼：　　

CREATE TABLE [dbo].[Post](
    [Id] [int] IDENTITY(1,1) NOT NULL,
    [Title] [nvarchar](50) NULL,
    [Content] [nvarchar](
 
2000) 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(1,1) NOT NULL,
    [Name] [nvarchar](20) 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 [email protected]", new { UserId = 1 });
            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 [email protected]
                           select * from [User] where [email protected]";

            using (var multi = conn.QueryMultiple(sql, new { Id = 1 }))
            {
                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 = 3 }, 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();
        }
    }