كيف تعمل النطاقات (Namespaces) وتوجيهات using؟

Question

Accepted Answer

**النطاقات (Namespaces)** تنظم الكود إلى مجموعات منطقية وتمنع تضارب الأسماء (مثل المجلدات للأنواع). **توجيهات `using`** تستورد النطاقات بحيث يمكنك الإشارة إلى أنواعها باسم مختصر. معاً، تنظم الكود في C# وتوفر الوصول إلى مكتبة .NET الضخمة. ## إعلان النطاقات ```csharp // declare a namespace (conventionally matching the folder structure) namespace MyApp.Services; // file-scoped namespace (C# 10) — applies to the whole file public class UserService { } // fully-qualified name: MyApp.Services.UserService // or block-scoped (traditional) namespace MyApp.Models { public class User { } } ``` النطاق يجمع الأنواع ذات الصلة تحت اسم واحد (`MyApp.Services.UserService`)، مما يمنع التضارب بين الفئات التي تحمل نفس الاسم في نطاقات مختلفة. النطاقات ذات النطاق الملفي (File-scoped namespaces) في C# 10 تقلل من التداخل. ## توجيهات using — استيراد النطاقات ```csharp using System; // import → use Console instead of System.Console using System.Collections.Generic; // → List, Dictionary using System.Linq; // → LINQ extension methods using MyApp.Services; // your own namespaces Console.WriteLine("hi"); // short name works thanks to `using System;` var list = new List(); // thanks to the Generic using ``` `using` في بداية الملف يستورد نطاقاً بحيث تكون أنواعه متاحة باسم مختصر (بدلاً من الاسم المؤهل بالكامل). تستورد مكتبات .NET التي تحتاجها بهذه الطريقة. ## استخدام الأسماء المستعارة و global usings ```csharp using Project = MyApp.Models.Project; // ALIAS — resolve a name conflict or shorten // GLOBAL using (C# 10) — apply to the ENTIRE project, declared once global using System; global using System.Collections.Generic; // → no need to repeat common usings in every file (often auto-generated) ``` **Global usings** (C# 10) تعلن الاستيرادات مرة واحدة لكل المشروع — .NET الحديث يشمل تلقائياً الاستيرادات الشائعة (`ImplicitUsings`)، لذا نادراً ما تكتب `using System;` في الوقت الحاضر. ## ملاحظة: توجيه using مقابل جملة using ```csharp using var file = File.OpenText("x.txt"); // using STATEMENT — auto-disposes (different feature!) ``` ## لماذا يهمك النطاقات وتوجيهات using أساسية لتنظيم كود C# والوصول إلى نظام .NET البيئي، لذا فهمها ضروري وأساسي يومياً. **النطاقات** تنظم الأنواع إلى مجموعات منطقية (تعكس هيكل المجلدات) وتمنع **تضارب الأسماء** — بدونها، ستتضارب فئاتك مع بعضها ومع مكتبة .NET الضخمة والحزم من جهات خارجية. **توجيهات `using`** هي كيفية الوصول إلى تلك المكتبة: استيراد النطاقات بحيث يمكنك استخدام أنواعها (`Console`, `List`, طرق LINQ) باسم مختصر بدلاً من الأسماء المؤهلة بالكامل — كل ملف C# يعتمد على usings للوصول إلى وظائف الإطار. معرفة كيفية إعلان النطاقات (بما فيها الصيغة الحديثة ذات النطاق الملفي)، الاستيراد باستخدام usings، استخدام الأسماء المستعارة لحل التضارب، والاستفادة من **global usings** (C# 10، إعلان الاستيرادات الشائعة مرة واحدة لكل المشروع — غالباً يتم إنشاؤها تلقائياً عبر ImplicitUsings، لذا نادراً ما تكتب boilerplate usings) ضروري لهيكلة المشاريع واستخدام الإطار. فهم النطاقات و usings — تنظيم الكود، منع التضارب، الوصول إلى مكتبة .NET، و global/implicit usings الحديثة التي تقلل من boilerplate — أساسي لأي تطوير C#، لأن كل برنامج ينظم الكود إلى نطاقات والوصول إلى الوظائف من خلال usings. (يستحق التمييز عن جملة `using`، وهي ميزة مختلفة للتخلص التلقائي من الموارد.)