Dapperの使い方のメモ

まずはデータを用意しないと試すことができないので、MicrosoftがAdventureWorksという架空の会社を想定したデータを公開しているので
SQL Serverをつかいます

• AdventureWorks

■Select

• スカラー値のクエリ
• １行データ取得
• 複数データ取得
• 複数のSelectした結果を取得

DataBaseは、SQL Serverで、データはAdventureWorks2022をいれています
→AdventureWorksについて

複数のSQLを１リクエストで投げて、結果を受け取るため

• QueryMultiple
• QueryMultipleAsync

を使います

そこから得た結果に対し、それぞれのSQLで取得されるであろう結果のレコード数に応じて以下を使い分ける感じ

※Asyncをつければ非同期版
※Singleは結果が１行じゃないと例外発生、Firstは最初の１行だけ返す

サンプル：
1回のリクエストで男性女性わけてデータを取り出す例

Employee.cs

namespace SampleDapper.Models.HumanResources
{
    public class Employee
    {
        // テーブルから取得したい列の情報を定義
        public int BusinessEntityID { get; set; }
        public string JobTitle { get; set; } = null!;
        public DateTime BirthDate { get; set; }
        public char Gender { get; set; }
        public DateTime HireDate { get; set; }
    }
}

Program.cs

using Dapper;
using Microsoft.Data.SqlClient;
using Microsoft.Extensions.Configuration;
using SampleDapper.Models.HumanResources;

try
{
    var config = new ConfigurationBuilder()
                    .SetBasePath(Directory.GetCurrentDirectory())
                    .AddJsonFile(@"appsettings.json")
                    .Build();

    var connectStr = config["ConnectionStrings:DefaultConnection"];

    using (var connection = new SqlConnection(connectStr))
    {
        connection.Open();

        // 任意の件数、取得するSQL
        var sql = @"
                    SELECT * FROM HumanResources.Employee WHERE Gender = @Gender1;
                    SELECT * FROM HumanResources.Employee WHERE Gender = @Gender2;
                   ";

        //　SQL中のパラメータに渡す値を設定
        var parameters = new { Gender1 = 'F', Gender2 = 'M' };

        using (var multi = connection.QueryMultiple(sql, parameters))
        {
            var femaleEmployees = multi.Read<Employee>();
            var maleEmployees = multi.Read<Employee>();
        }
    }
}
catch(Exception ex)
{
    Console.Write(ex.ToString());
}

DataBaseは、SQL Serverで、データはAdventureWorks2022をいれています
→AdventureWorksについて

複数データが返ってくる場合は、以下メソッドを使います

• Query
• QueryAsync

サンプル：
Employee.cs

namespace SampleDapper.Models.HumanResources
{
    public class Employee
    {
        // テーブルから取得したい列の情報を定義
        public int BusinessEntityID { get; set; }
        public string JobTitle { get; set; } = null!;
        public DateTime BirthDate { get; set; }
        public char Gender { get; set; }
        public DateTime HireDate { get; set; }
    }
}

Program.cs

using Dapper;
using Microsoft.Data.SqlClient;
using Microsoft.Extensions.Configuration;
using SampleDapper.Models.HumanResources;

try
{
    var config = new ConfigurationBuilder()
                    .SetBasePath(Directory.GetCurrentDirectory())
                    .AddJsonFile(@"appsettings.json")
                    .Build();

    var connectStr = config["ConnectionStrings:DefaultConnection"];

    using (var connection = new SqlConnection(connectStr))
    {
        connection.Open();

        // 任意の件数、取得するSQL
        var sql = "SELECT * FROM HumanResources.Employee WHERE Gender = @Gender AND JobTitle = @JobTitle";

        //　SQL中のパラメータに渡す値を設定
        var parameters = new { Gender = 'F', JobTitle = "Design Engineer" };

        var recordList = connection.Query<Employee>(sql, parameters);
    }
}
catch(Exception ex)
{
    Console.Write(ex.ToString());
}

DataBaseは、SQL Serverで、データはAdventureWorks2022をいれています
→AdventureWorksについて

主キーで絞り込みのように１行データを取得する場合

※Asyncをつければ非同期版

サンプル：
Employee.cs

namespace SampleDapper.Models.HumanResources
{
    public class Employee
    {
        // テーブルから取得したい列の情報を定義
        public int BusinessEntityID { get; set; }
        public string JobTitle { get; set; } = null!;
        public DateTime BirthDate { get; set; }
        public char Gender { get; set; }
        public DateTime HireDate { get; set; }
    }
}

Program.cs

using Dapper;
using Microsoft.Data.SqlClient;
using Microsoft.Extensions.Configuration;
using SampleDapper.Models.HumanResources;

try
{
    var config = new ConfigurationBuilder()
                    .SetBasePath(Directory.GetCurrentDirectory())
                    .AddJsonFile(@"appsettings.json")
                    .Build();

    var connectStr = config["ConnectionStrings:DefaultConnection"];

    using (var connection = new SqlConnection(connectStr))
    {
        connection.Open();

        // 主キーで1件取得するSQL
        var sql = "SELECT * FROM HumanResources.Employee WHERE BusinessEntityID = @BusinessEntityID";

        //　SQL中のパラメータに渡す値を設定
        var parameters = new { BusinessEntityID = 36 };

        var record = connection.QuerySingle<Employee>(sql, parameters);
    }
}
catch(Exception ex)
{
    Console.Write(ex.ToString());
}

DataBaseは、SQL Serverで、データはAdventureWorks2022をいれています
→AdventureWorksについて

Count、Sum、Avg、Max、Minなどの１データ取得する場合に以下メソッドを使用します

• ExecuteScalar
• ExecuteScalarAsync

サンプル：

using Dapper;
using Microsoft.Data.SqlClient;
using Microsoft.Extensions.Configuration;

try
{
    var config = new ConfigurationBuilder()
                    .SetBasePath(Directory.GetCurrentDirectory())
                    .AddJsonFile(@"appsettings.json")
                    .Build();

    var connectStr = config["ConnectionStrings:DefaultConnection"];

    using (var connection = new SqlConnection(connectStr))
    {
        connection.Open();

        var sql = "SELECT COUNT(*) FROM HumanResources.Employee";
        var count = connection.ExecuteScalar<int>(sql);
    }
}
catch(Exception ex)
{
    Console.Write(ex.ToString());
}