Cum funcționează spațiile de nume (namespaces) și directivele using?

Question

Accepted Answer

**Spațiile de nume** organizează codul în grupuri logice și previn coliziunile de denumiri (ca directoare pentru tipuri). **Directivele `using`** importă spații de nume pentru a putea referi tipurile lor cu nume scurt. Împreună structurează codul C# și oferă acces la vasta bibliotecă .NET. ## Declararea spațiilor de nume ```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 { } } ``` Un spațiu de nume grupează tipuri conexe sub un nume (`MyApp.Services.UserService`), prevenind coliziunile între clase cu același nume din spații de nume diferite. Spațiile de nume cu domeniu de fișier (C# 10) reduc imbrication. ## Directivele using — importarea spațiilor de nume ```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` la începutul unui fișier importă un spațiu de nume pentru ca tipurile acestuia să fie disponibile cu nume scurt (în loc de numele complet calificat). Importați bibliotecile .NET de care aveți nevoie în acest fel. ## Alias-uri using și using globale ```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) ``` **Using-urile globale** (C# 10) declară importuri o singură dată pentru întregul proiect — .NET modern include automat pe cele comune (`ImplicitUsings`), deci rareori mai scrieți `using System;`. ## Notă: directivă using vs declarație using ```csharp using var file = File.OpenText("x.txt"); // using STATEMENT — auto-disposes (different feature!) ``` ## De ce conteaza Spațiile de nume și directivele using sunt fundamentale pentru organizarea codului C# și accesul la ecosistemul .NET, deci înțelegerea lor este cunoștință esențială de zi cu zi. **Spațiile de nume** organizează tipurile în grupuri logice (reflectând structura de directoare) și previn **coliziunile de denumiri** — fără ele, clasele voastre s-ar ciocni între ele și cu vasta bibliotecă .NET și pachetele terțe. **Directivele `using`** sunt modul în care accesați acea bibliotecă: importând spații de nume pentru a putea folosi tipurile lor (`Console`, `List`, metode LINQ) cu nume scurt mai degrabă decât cu nume complet calificat — fiecare fișier C# se bazează pe using-uri pentru a accesa funcționalitatea framework-ului. Înțelegerea modului de declarare a spațiilor de nume (inclusiv sintaxa modernă cu domeniu de fișier), importul cu using-uri, utilizarea alias-urilor pentru rezolvarea conflictelor și valorificarea **using-urilor globale** (C# 10, declarând importuri comune o singură dată pentru întregul proiect — acum adesea generate automat prin ImplicitUsings, deci rareori scrieți using-uri standard) este necesară pentru structurarea proiectelor și utilizarea framework-ului. Înțelegerea spațiilor de nume și using-urilor — organizarea codului, prevenirea coliziunilor, accesul la biblioteca .NET, și using-urile moderne globale/implicite care reduc codul standard — este fundamental pentru orice dezvoltare C#, deoarece fiecare program organizează codul în spații de nume și accesează funcționalități prin using-uri. (Merită distins de declarația `using`, o caracteristică diferită pentru eliberarea automată a resurselor.)