ما هي السجلات (Records) في C#؟

Question

Accepted Answer

**السجلات** (Records) (C# 9+) هي طريقة موجزة لتعريف الأنواع التي تكون في المقام الأول **حاملات بيانات غير قابلة للتغيير** مع **المساواة المبنية على القيمة**. تقوم بإنشاء الكود المتكرر تلقائياً (المُنشئ، المساواة، `ToString`، إلخ)، مما يجعلها مثالية لـ DTOs والقيم المجالية ونمذجة البيانات.

## تعريف السجل (الصيغة الموضعية)

```csharp
// one line generates: constructor, properties, equality, ToString, deconstruction
public record Person(string Name, int Age);

var p1 = new Person("Ann", 30);
p1.Name;                          // "Ann" (read-only property)
Console.WriteLine(p1);             // Person { Name = Ann, Age = 30 } — ToString generated
```

الصيغة الموضعية `record Person(string Name, int Age)` تولد كل شيء — الخصائص والمُنشئ و`ToString` والمساواة وفك الربط — مما يلغي الكود المتكرر الذي ستحتاجه فئة عادية.

## المساواة المبنية على القيمة (الفرق الرئيسي عن الفئات)

```csharp
var a = new Person("Ann", 30);
var b = new Person("Ann", 30);
a == b;        // TRUE — records compare by VALUE (all properties equal)
// (a regular class would be FALSE here — classes compare by reference)
```

على عكس الفئات (التي تقارن بمعرّف المرجع)، تقارن السجلات بـ **القيمة** — سجلان لهما نفس قيم الخصائص متساويان. هذا هو بالضبط ما تريده لكائنات البيانات.

## عدم القابلية للتغيير والطفرة غير المدمرة (مع with)

```csharp
public record Person(string Name, int Age);   // properties are init-only (immutable)

var p1 = new Person("Ann", 30);
var p2 = p1 with { Age = 31 };   // `with` creates a COPY with some properties changed
// p1 unchanged (immutable); p2 = Person { Name = Ann, Age = 31 }
```

السجلات غير قابلة للتغيير بشكل افتراضي، و**تعبير `with`** ينشئ نسخة معدلة (طفرة غير مدمرة) — مثالية للعمل مع البيانات غير القابلة للتغيير.

## record class مقابل record struct

```csharp
public record class Ref(int X);    // a reference type (default) with value equality
public record struct Val(int X);   // a VALUE type record (C# 10)
```

## لماذا يُهم

السجلات هي ميزة C# حديثة مهمة (C# 9+) تجعل تعريف الأنواع البيانية غير القابلة للتغيير موجزاً وصحيحاً، لذا فإن فهمها ذو قيمة لتطوير C# الحديث.

فوائدها الرئيسية تعالج احتياجات حقيقية: تقوم **بإلغاء الكود المتكرر** (بإنشاء المُنشئات والخصائص و`ToString` والمساواة وفك الربط تلقائياً من إعلان بسطر واحد — مقابل الكود الكبير الذي ستحتاجه فئة عادية)، وتوفر **مساواة مبنية على القيمة** (سجلان بخصائص متساوية متساويان، على عكس الفئات التي تقارن بالمرجع) — وهذا هو بالضبط السلوك الذي تريده لكائنات البيانات و DTOs والقيم المجالية، والذي تخطئ فيه الفئات بشكل افتراضي.

السجلات أيضاً **غير قابلة للتغيير بشكل افتراضي** مع **تعبير `with`** الأنيق للطفرة غير المدمرة (إنشاء نسخ معدلة)، مما يدعم الأسلوب غير القابل للتغيير والوظيفي الذي يفضله بشكل متزايد للكود الأكثر أماناً وقابلية للتنبؤ.

فهم السجلات — الصيغة الموجزة والمساواة على القيمة وعدم القابلية للتغيير مع `with` وسجلات البنى — ذو قيمة لكتابة C# نظيف وحديث، لأنها الطريقة الاصطلاحية لنمذجة البيانات (DTOs وموديلات API وكائنات القيمة والحالة غير القابلة للتغيير) وتُستخدم على نطاق واسع في قواعد البيانات الحالية.

معرفة متى تستخدم سجل (بيانات غير قابلة للتغيير مع دلالات القيمة) مقابل فئة (كائنات قابلة للتغيير مع الهوية والسلوك الغني) تعكس الطلاقة مع C# الحديث.

بما أن السجلات تبسط نمذجة البيانات بشكل كبير مع توفير مساواة صحيحة وعدم قابلية للتغيير — احتياجات شائعة كانت مملة وعرضة للأخطاء من قبل — فهي ميزة مهمة وكثيرة الاستخدام وهي علامة من علامات كود C# النظيف والحديث.