Dapper - ExecuteScalar Metodu

Bu yazımda Dapper ORM'de bulunan ExecuteScalar metodunun kullanımını örneklerle anlatacağım. 

Normalde SqlCommand sınıfının bir metodu olarak da bilinen ExecuteScalar, sorgumuzdan tek bir değerin dönmesini sağlar. object tipinde dönüş tipi vardır. Kaynak için tıklayınız. 

Dapper ORM'de ise IDbConnection için extension metot olduğu için bir connection oluşturduktan sonra bu metodu çağırabiliriz. ExecuteScalar metodunda kullanılan parametreler aşağıdaki gibidir.

Adı	Tanım
sql	Sql sorgumuzu yazacağımız alan
param	Eğer sql sorgumuz parametre içerdiği durumlarda kullanılır.(varsayılan= null)
transaction	Transaction varsa kullanılır.(varsayılan= null)
commandTimeout	Command timeout'unu burada tanımlarız.(varsayılan= null)
commandType	Sql sorgu türümüzü tanımlarız.Eğer Stored Procedure kullanacaksak bu parametreyi ekleriz.(varsayılan= null)

Bu metodun kullanımını örneklerle anlatalım. Northwind veri tabanı kullanılmıştır.

Metodumuzda ilk parametre olarak parametrik olarak bir SQL sorgusu yazdık, diğer parametremiz ise sorgumuz parametre alacağı için parametremize ait değeri gönderdik.

SQL sorgumuzda parametre olarak gönderilen ProductId için ProductName bilgisi alınacaktır. Dapper ORM'de bu metot generic olarak string verilerek ekstra bir dönüştürme işlemine gerek duyulmamıştır.

Eğer generic olarak tanımlamasaydık, metodumuzun sonunda dönüştürme işlemi yapmamız gerekecektir. Örneğimizde; değer string olacağı için ToString kullanarak objecti stringe dönüştürdük. Kodumuzun son hali aşağıdaki gibidir.

Dapper ExecuteScalar Metodu için kütüphanenin tutorial sitesinden yararlandım. İncelemek için tıklayabilirsiniz.