Jak działają przestrzenie nazw i dyrektywy using?

Question

Accepted Answer

**Przestrzenie nazw** organizują kod w logiczne grupy i zapobiegają kolizjom nazw (jak foldery dla typów). **Dyrektywy `using`** importują przestrzenie nazw, aby można było odwoływać się do ich typów przez krótką nazwę. Razem strukturują kod C# i umożliwiają dostęp do ogromnej biblioteki .NET. ## Deklarowanie przestrzeni nazw ```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 { } } ``` Przestrzeń nazw grupuje powiązane typy pod nazwą (`MyApp.Services.UserService`), zapobiegając kolizjom między klasami o tej samej nazwie w różnych przestrzeniach nazw. Przestrzenie nazw ograniczone do pliku (C# 10) zmniejszają zagnieżdżenie. ## Dyrektywy using — importowanie przestrzeni nazw ```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` na szczycie pliku importuje przestrzeń nazw, aby jej typy były dostępne przez krótką nazwę (zamiast w pełni kwalifikowanej nazwy). W ten sposób importujesz potrzebne biblioteki .NET. ## Using aliasy i globalne using'i ```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) ``` **Globalne using'i** (C# 10) deklarują importy raz dla całego projektu — nowoczesne .NET automatycznie włącza popularne (`ImplicitUsings`), więc rzadko piszesz `using System;`. ## Uwaga: dyrektywa using vs instrukcja using ```csharp using var file = File.OpenText("x.txt"); // using STATEMENT — auto-disposes (different feature!) ``` ## Dlaczego to ważne Przestrzenie nazw i dyrektywy using są fundamentem organizowania kodu C# i dostępu do ekosystemu .NET, dlatego zrozumienie ich jest niezbędną wiedzą codzienną. **Przestrzenie nazw** organizują typy w logiczne grupy (odzwierciedlające strukturę folderów) i zapobiegają **kolizjom nazw** — bez nich twoje klasy wchodziłyby w konflikt ze sobą i z ogromną biblioteką .NET oraz pakietami zewnętrznymi. **Dyrektywy `using`** są sposobem dostępu do tej biblioteki: importujesz przestrzenie nazw, aby móc używać ich typów (`Console`, `List`, metody LINQ) przez krótką nazwę zamiast w pełni kwalifikowanych nazw — każdy plik C# opiera się na using'ach, aby uzyskać dostęp do funkcjonalności frameworka. Wiedza, jak deklarować przestrzenie nazw (włączając nowoczesną składnię ograniczoną do pliku), importować za pomocą using'ów, używać aliasów do rozwiązywania konfliktów i wykorzystywać **globalne using'i** (C# 10, deklarujące popularne importy raz dla całego projektu — teraz często generowane automatycznie przez ImplicitUsings, więc rzadko piszesz standardowe using'i) jest niezbędna do strukturowania projektów i korzystania z frameworka. Zrozumienie przestrzeni nazw i using'ów — organizacji kodu, zapobiegania kolizjom, dostępu do biblioteki .NET oraz nowoczesnych globalnych/niejawnych using'ów, które zmniejszają boilerplate — jest fundamentem dla każdego programowania w C#, ponieważ każdy program organizuje kod w przestrzeniach nazw i uzyskuje dostęp do funkcjonalności poprzez using'i. (Warto rozróżnić od instrukcji `using`, innej funkcji do automatycznego zwolniania zasobów.)