Distinct حسب حقل واحد في C#: كيفية إزالة التكرارات من الكائنات

المشكلة: Distinct() لا يعرف التصفية حسب الحقل

تخيل: لديك قائمة بالعملاء، وفيها تكرارات حسب البريد الإلكتروني. تكتب:

var uniqueClients = clients.Distinct().ToList();

وتتفاجأ بأن التكرارات لم تختفِ. لماذا؟ لأن Distinct() القياسي يقارن الكائنات كاملة حسب المرجع (أو حسب Equals إذا قمت بإعادة تعريفه). إنه لا يعلم أن "التفرد" بالنسبة لك هو Email فريد، وليس نسخة فريدة من الكلاس.

هذا السؤال هو من أكثر الأسئلة شيوعاً على Stack Overflow حول LINQ (أكثر من 500 ألف مشاهدة). واليوم سنشرح 3 طرق عملية لحل هذه المشكلة في C#. هيا بنا!

الطريقة 1: GroupBy + First (الكلاسيكية)

أبسط وأوضح طريقة، ولا تتطلب تثبيت مكتبات خارجية. الفكرة: تجميع الكائنات حسب الخاصية المطلوبة، ثم أخذ أول عنصر من كل مجموعة.

var uniqueByEmail = clients\n    .GroupBy(c => c.Email)\n    .Select(g => g.First())\n    .ToList();

كيف يعمل:

\n
• GroupBy(c => c.Email) — يقسم المجموعة إلى مجموعات فرعية، حيث المفتاح هو البريد الإلكتروني.
\n
• Select(g => g.First()) — يأخذ أول كائن من كل مجموعة فرعية.
\n
• يتم تجاهل التكرارات المتبقية.
\n

الإيجابيات:

\n
• يعمل "مباشرة من الصندوق" (فقط using System.Linq;).
\n
• مفهوم بديهياً حتى للمبتدئين.
\n
• يحافظ على الترتيب الأصلي للعناصر (يبقى أول كائن تم العثور عليه).
\n

السلبيات:

\n
• أبطأ قليلاً على البيانات الكبيرة (يحتاج لإنشاء مجموعات).
\n
• الكود أطول قليلاً مما نرغب.
\n

الطريقة 2: MoreLinq و DistinctBy (الأناقة)

إذا كنت لا تمانع المكتبات الخارجية، فإن MoreLinq تقدم طريقة مثالية DistinctBy. تقوم بالضبط بما تتوقعه من Distinct — التصفية حسب الخاصية.

التثبيت عبر NuGet:

Install-Package MoreLinq

الاستخدام:

using MoreLinq;\n\nvar uniqueByEmail = clients.DistinctBy(c => c.Email).ToList();

سطر واحد فقط وكل شيء جاهز. داخلياً، تستخدم DistinctBy HashSet وتعمل بتعقيد O(n).

الإيجابيات:

\n
• كود موجز وقابل للقراءة للغاية.
\n
• أداء عالٍ.
\n
• المكتبة مختبرة جيداً (أكثر من 10 ملايين تحميل).
\n

السلبيات:

\n
• تحتاج لإضافة تبعية للمشروع.
\n
• ليست كل الفرق تسمح بالمكتبات الخارجية.
\n

الطريقة 3: IEqualityComparer مخصص (التحكم الكامل)

هذه الطريقة مناسبة عندما لا تريد إضافة مكتبة، ولكنك تريد إعادة استخدام منطق المقارنة في عدة أماكن. ننشئ المقارن الخاص بنا:

public class ClientEmailComparer : IEqualityComparer<Client>\n{\n    public bool Equals(Client x, Client y)\n    {\n        if (ReferenceEquals(x, y)) return true;\n        if (x is null || y is null) return false;\n        return x.Email == y.Email;\n    }\n\n    public int GetHashCode(Client obj)\n    {\n        return obj.Email?.GetHashCode() ?? 0;\n    }\n}

الاستخدام:

var comparer = new ClientEmailComparer();\nvar uniqueByEmail = clients.Distinct(comparer).ToList();

الإيجابيات:

\n
• تحكم كامل في منطق المقارنة.
\n
• يمكن إعادة استخدام المقارن في Contains و Except و Union وغيرها.
\n
• لا يتطلب مكتبات خارجية.
\n

السلبيات:

\n
• الكثير من الكود النمطي.
\n