Si funksionojnë namespace-et dhe direktiva using?

Question

Accepted Answer

**Namespace-et** organizojnë kodin në grupe logjike dhe parandalojnë përplasjet e emërtimit (si dosjet për llojet). **Direktiva `using`** importojnë namespace-et në mënyrë që të mund të referoheni në llojet e tyre me emrin e shkurtër. Së bashku ato strukturojnë kodin C# dhe ofrojnë qasje në bibliotekën e gjerë .NET. ## Deklarimi i namespace-eve ```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 { } } ``` Një namespace grupon llojet përkatëse nën një emër (`MyApp.Services.UserService`), duke parandaluar përplasjet midis klasave me të njëjtën emër në namespace-e të ndryshme. Namespace-et me fushë-dosje (C# 10) zvogëlojnë nënzotësimin. ## using direktiva — importim i namespace-eve ```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` në fillim të një file-i importon një namespace në mënyrë që llojet e tij të jenë të disponueshme me emrin e shkurtër (në vend të emrit plotësisht-kualifikuar). Importoni biblioteka .NET që ju nevojiten në këtë mënyrë. ## using alias-et dhe 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) deklarojnë importimet një herë për të gjithë projektin — .NET moderne përfshin automatikisht të zakonshmet (`ImplicitUsings`), prandaj rrallë shkruani `using System;` më shumë. ## Shënim: using direktiva kundrejt using statement-it ```csharp using var file = File.OpenText("x.txt"); // using STATEMENT — auto-disposes (different feature!) ``` ## Pse është e rëndësishme Namespace-et dhe direktivat using janë thelbësor për organizimin e kodit C# dhe qasjen në ekosistemit .NET, kështu që përpunimi i tyre është njohuri thelbësore përditore. **Namespace-et** organizojnë llojet në grupe logjike (pasqyrim i strukturës së foldersit) dhe parandalojnë **përplasjet e emërtimit** — pa to, klasat tuaja do të përplasen me njëra-tjetrën dhe me bibliotekën e gjerë .NET dhe paketat palësh të treta. **Direktivat `using`** janë si ju qasni atë bibliotekë: importim i namespace-eve në mënyrë që të mund të përdorni llojet e tyre (`Console`, `List`, metodat LINQ) me emrin e shkurtër në vend të emrave plotësisht-kualifikuar — çdo file C# mbështetet në usings për qasje në funksionalitetin e framework-it. Dija se si të deklaroni namespace-et (përfshirë sintaksën moderne me fushë-file), të importoni me usings, të përdorni alias-et për zgjidhjen e konflikteve, dhe të përfitoni nga **global usings** (C# 10, deklarim i importimeve të zakonshme një herë për të gjithë projektin — tani shpesh të gjeneruara automatikisht përmes ImplicitUsings, kështu që rrallë shkruani boilerplate usings) është e nevojshme për strukturimin e projekteve dhe përdorimin e framework-it. Përmbajtja e namespace-eve dhe usings-ve — organizimi i kodit, parandalimi i përplasjeve, qasja në bibliotekën .NET, dhe global/implicit usings-et moderne që zvogëlojnë boilerplate-in — është thelbësor për çdo zhvillim C#, pasi çdo program organizon kodin në namespace-e dhe qasja në funksionalitet përmes usings-ve. (Vlen të dallojmë nga statement-i `using`, një veçori e ndryshme për hedhjen automatike të burimeve.)