ما هي الانعكاسات (Reflection) والسمات (Attributes) المستخدمة؟

Question

Accepted Answer

**الانعكاس (Reflection)** يسمح لأي برنامج **بفحص ومعالجة الأنواع والدوال والخصائص في وقت التشغيل** — حتى تلك التي لم تكن معروفة في وقت الترجمة. **السمات (Attributes)** تربط **البيانات الوصفية (metadata)** الإعلانية بالكود الذي تقرأه الأدوات والأطر العمل (غالباً عبر الانعكاس) لتحريك السلوك. معاً تقودان الكثير من "السحر" في إطار عمل .NET (التسلسل، حقن التبعيات، مكتبات ORM، التحقق من الصحة).

## الانعكاس — الفحص والاستدعاء في وقت التشغيل

```csharp
// examine a type's structure at runtime
Type type = typeof(User);
foreach (PropertyInfo prop in type.GetProperties())
    Console.WriteLine($"{prop.Name}: {prop.PropertyType}");

foreach (MethodInfo method in type.GetMethods()) { }

// create instances and invoke members dynamically
object instance = Activator.CreateInstance(type);   // create without knowing the type at compile time
PropertyInfo p = type.GetProperty("Name");
p.SetValue(instance, "Ann");                         // set a property reflectively
```

يسمح الانعكاس للكود بالكشف واستخدام الأنواع بشكل ديناميكي — إنشاء نسخة من نوع معين، قراءة/تعيين الخصائص، استدعاء الدوال — وهذا هو كيف تعمل الأطر العمل على *أنواعك* دون معرفتها مقدماً.

## السمات — البيانات الوصفية الإعلانية

```csharp
// built-in and framework attributes attach metadata to code
[Obsolete("Use NewMethod instead")]
[Serializable]
public class OldClass { }

public class User
{
    [Required]                          // validation attribute (ASP.NET)
    [StringLength(100)]
    public string Name { get; set; }

[JsonPropertyName("email_address")]  // serialization attribute
    public string Email { get; set; }
}

[HttpGet("/users/{id}")]                 // ASP.NET routing attribute
public User Get(int id) { }
```

توضح السمات الكود بالبيانات الوصفية التي تقرأها أطر العمل لتحريك السلوك — قواعد التحقق من الصحة، أسماء التسلسل، التوجيه، إلخ.

## السمات المخصصة + الانعكاس (كيفية عمل الأطر)

```csharp
public class AuditAttribute : Attribute { public string Action; }

[Audit(Action = "delete")]
public void DeleteUser(int id) { }

// a framework reads the attribute via reflection and acts on it
var attr = method.GetCustomAttribute<AuditAttribute>();
if (attr != null) Log(attr.Action);   // wrap/log/intercept based on the metadata
```

هذه هي الآلية وراء ASP.NET (`[HttpGet]`، `[Authorize]`)، والتحقق من الصحة (`[Required]`)، والتسلسل (`[JsonPropertyName]`)، وORMs، وأطر اختبار — فهي تمسح الكود المعلم عبر الانعكاس وتربط السلوك.

## لماذا هذا مهم

الانعكاس والسمات هي **الآلية الكامنة وراء الكثير من وظائف إطار عمل .NET**، لذا فإن فهمهما ذو قيمة لاستيعاب كيفية عمل الأطر العمل وللسيناريوهات المتقدمة. **الانعكاس** يمكّن السلوك العام والديناميكي — فحص وتشغيل الأنواع في وقت التشغيل دون معرفة التجميع — وهذا هو كيفية عمل حقن التبعيات، والتسلسل (مكتبات JSON/XML تقرأ الخصائص)، وORMs (تعيين الكائنات لجداول قواعد البيانات)، وأطر العمل على أنواعك العشوائية. **السمات** توفر البيانات الوصفية الإعلانية التي تقرأها هذه الأدوات (عبر الانعكاس) لتحريك سلوكها، مما يحل محل التكوين المطول بتعليقات توضيحية بسيطة (`[Required]` للتحقق من الصحة، `[HttpGet]` للتوجيه، `[JsonPropertyName]` للتسلسل، `[Authorize]` للأمان).

يساعدك الفهم **على كشف غموض ASP.NET Core و Entity Framework والتحقق من الصحة والتسلسل وأطر اختبار "السحر" الإعلاني** — بالاعتراف بأن السمات تعلم الكود والانعكاس يقرأ ويتصرف بناءً على تلك العلامات.

هذه المعرفة قيمة لاستخدام هذه الأطر العمل بفعالية، وبناء أدوات أو مكتبات تشبه الأطر العمل (السمات المخصصة + الانعكاس)، وفهم المقايضات (الانعكاس أبطأ من الاستدعاءات المباشرة ويتجاوز بعض فحوصات التجميع، لذا يتم استخدامه بحذر).

بينما متقدم وليس برمجة يومية، فإن فهم الانعكاس والسمات هو معرفة مهمة على مستوى كبار المهندسين للعمل بعمق في نظام .NET البيئي — فهو يشرح كيف تعمل الأطر العمل التي تستخدمها يومياً بالفعل، ويمكّن البرمجة الوصفية المتقدمة، وهو موضوع ذي صلة لفهم معمارية .NET وبناء مكتبات موجهة بالسمات وقابلة للتوسع، مما يجعله معرفة جديرة بالاهتمام تميز المطورين بفهم عميق لـ .NET.