Dapper C# (.NET) पूर्ण गाइड: उदाहरण, विधियाँ, स्थापना

Dapper का परिचय: यह क्या है और क्यों ज़रूरी है?

Dapper एक हल्की-फुल्की लाइब्रेरी (Micro ORM) है जो .NET प्लेटफॉर्म के लिए Stack Overflow टीम द्वारा विकसित की गई है। यह IDbConnection का एक एक्सटेंशन है और डेटाबेस में SQL क्वेरीज़ को न्यूनतम ओवरहेड के साथ निष्पादित करने के लिए डिज़ाइन किया गया है। भारी-भरकम ORM (जैसे Entity Framework Core) के विपरीत, Dapper ऑब्जेक्ट में बदलावों को ट्रैक नहीं करता, जटिल SQL क्वेरीज़ जनरेट नहीं करता, और डेटा कॉन्टेक्स्ट सेटअप की आवश्यकता नहीं होती। इसका मुख्य उद्देश्य अधिकतम प्रदर्शन और सरलता है।

Dapper के मुख्य लाभ:

• गति: Dapper लगभग रॉ ADO.NET कमांड की गति से काम करता है, क्योंकि यह परिणामों को मैप करने के लिए डायनामिक IL-कोड जनरेशन का उपयोग करता है।
• सरलता: क्वेरीज़ निष्पादित करने के लिए न्यूनतम कोड। जटिल कॉन्फ़िगरेशन की ज़रूरत नहीं।
• SQL पर नियंत्रण: आप SQL क्वेरीज़ स्वयं लिखते हैं, जिससे आपको पूरा नियंत्रण मिलता है कि कौन सा डेटा और कैसे प्राप्त किया जाए।
• लचीलापन: किसी भी ADO.NET प्रदाता (SQL Server, PostgreSQL, MySQL, SQLite, आदि) के साथ काम करता है।
• विस्तारशीलता: मौजूदा प्रोजेक्ट्स और अन्य ORM के साथ आसानी से एकीकृत होता है।

Dapper उन प्रोजेक्ट्स के लिए आदर्श है जहाँ प्रदर्शन और SQL पर सीधा नियंत्रण महत्वपूर्ण है, साथ ही माइक्रोसर्विसेज़ और उच्च-लोड वाले एप्लिकेशन के लिए भी।

Dapper की स्थापना (Installation)

Dapper NuGet के माध्यम से वितरित किया जाता है, जो .NET का पैकेज मैनेजर है। इसे कई तरीकों से स्थापित किया जा सकता है:

पैकेज मैनेजर कंसोल (Visual Studio) के माध्यम से:

Install-Package Dapper

.NET CLI के माध्यम से (अनुशंसित तरीका):

dotnet add package Dapper

Visual Studio में NuGet इंटरफ़ेस के माध्यम से:

1. प्रोजेक्ट पर राइट-क्लिक करें → "NuGet पैकेज प्रबंधित करें" चुनें।
2. "ब्राउज़" टैब पर जाएँ।
3. "Dapper" खोजें और "इंस्टॉल" पर क्लिक करें।

स्थापना के बाद, प्रोजेक्ट में Dapper.dll असेंबली का संदर्भ जुड़ जाएगा। किसी अतिरिक्त निर्भरता की आवश्यकता नहीं है — लाइब्रेरी मानक System.Data के ऊपर काम करती है।

कोड उदाहरण के साथ त्वरित शुरुआत

Dapper के साथ काम करने का एक न्यूनतम उदाहरण देखते हैं। मान लीजिए कि हमारे पास SQL Server डेटाबेस में Users नामक एक तालिका है:

CREATE TABLE Users (
    Id INT PRIMARY KEY IDENTITY,
    Name NVARCHAR(100) NOT NULL,
    Age INT NOT NULL
);

सभी उपयोगकर्ताओं को प्राप्त करने के लिए C# कोड:

using System.Data.SqlClient;
using Dapper;

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
}

class Program
{
    static void Main()
    {
        string connectionString = "Server=localhost;Database=TestDB;Trusted_Connection=True;";
        using (var connection = new SqlConnection(connectionString))
        {
            connection.Open();
            
            // सरल SELECT क्वेरी
            var users = connection.Query<User>("SELECT * FROM Users");
            
            foreach (var user in users)
            {
                Console.WriteLine($"{user.Id}: {user.Name}, {user.Age} वर्ष");
            }
        }
    }
}

जैसा कि आप देख सकते हैं, Dapper स्वचालित रूप से SQL क्वेरी के परिणामों को C# ऑब्जेक्ट्स पर मैप करता है। Query<T> विधि SELECT क्वेरीज़ निष्पादित करने के लिए मुख्य विधि है।

Dapper के मुख्य तरीके/फ़ंक्शन

Dapper IDbConnection इंटरफ़ेस के लिए एक्सटेंशन विधियों का एक सेट प्रदान करता है। आइए 10 प्रमुख विधियों को देखें।

1. Query<T>

क्या करता है: SQL क्वेरी निष्पादित करता है और निर्दिष्ट प्रकार T के ऑब्जेक्ट्स का संग्रह लौटाता है। इसका उपयोग SELECT क्वेरीज़ के लिए किया जाता है जो कई पंक्तियाँ लौटाती हैं।

पैरामीटर:

• sql (string) — SQL क्वेरी।
• pa