Çfarë janë records në C#?

Question

Accepted Answer

**Records** (C# 9+) janë një mënyrë e koncizë për të përcaktuar lloje që janë kryesisht **bartës të dhënash të pandryshueshëm** me **barazim të bazuar në vlerë**. Ato gjenerojnë automatikisht kodin standard (konstruktor, barazim, `ToString`, etj.), duke i bërë ato ideale për DTOs, vlerat e domenit, dhe modelimin e të dhënave.

## Përcaktimi i një record (sintaksa pozicionale)

```csharp
// one line generates: constructor, properties, equality, ToString, deconstruction
public record Person(string Name, int Age);

var p1 = new Person("Ann", 30);
p1.Name;                          // "Ann" (read-only property)
Console.WriteLine(p1);             // Person { Name = Ann, Age = 30 } — ToString generated
```

Sintaksa pozicionale `record Person(string Name, int Age)` gjeneron gjithçka — veti, konstruktor, `ToString`, barazim, dekonstruksion — duke eliminuar kodin standard që do të nevojitej për një klasë të rregullt.

## Barazim i bazuar në vlerë (dallimi kryesor nga klasat)

```csharp
var a = new Person("Ann", 30);
var b = new Person("Ann", 30);
a == b;        // TRUE — records compare by VALUE (all properties equal)
// (a regular class would be FALSE here — classes compare by reference)
```

Ndryshe nga klasat (të cilat krahasojnë përmes identitetit të referencës), records krahasojnë sipas **vlerës** — dy records me të njëjtat vlera vetish janë të barabartë. Kjo është pikërisht ajo që dëshironi për objektet e të dhënave.

## Pandryshueshmëria dhe mutacioni jo-shkatërrues (with)

```csharp
public record Person(string Name, int Age);   // properties are init-only (immutable)

var p1 = new Person("Ann", 30);
var p2 = p1 with { Age = 31 };   // `with` creates a COPY with some properties changed
// p1 unchanged (immutable); p2 = Person { Name = Ann, Age = 31 }
```

Records janë të pandryshueshëm në parazgjedhje, dhe **`with` shprehja** krijon një kopje të ndryshuar (mutacion jo-shkatërrues) — ideale për të punuar me të dhëna të pandryshueshme.

## record class vs record struct

```csharp
public record class Ref(int X);    // a reference type (default) with value equality
public record struct Val(int X);   // a VALUE type record (C# 10)
```

## Përse ka rëndësi

Records janë një tipar i rëndësishëm modern i C# (C# 9+) që e bën përcaktimin e llojeve të pandryshueshëm të të dhënave të koncizë dhe të saktë, kështu që kuptimi i tyre është i vlefshëm për zhvillimin modern të C#.

Benefitet e tyre kryesor përmbushin nevojat reale: ato **eliminojnë kodin standard** (auto-gjenerojnë konstruktore, veti, `ToString`, barazim, dhe dekonstruksion nga një deklarim njëlinjor — përkundrejt kodit të konsiderueshëm që do të nevojitej për një klasë të rregullt), dhe ato ofrojnë **barazim të bazuar në vlerë** (dy records me veti të barabarta janë të barabartë, ndryshe nga klasat të cilat krahasojnë sipas referencës) — gjë që është pikërisht sjellja që dëshironi për objektet e të dhënave, DTOs, dhe vlerat e domenit, dhe gjë që klasat e ngatërrojnë në parazgjedhje.

Records janë gjithashtu **të pandryshueshëm në parazgjedhje** me **`with` shprehjen** elegante për mutacion jo-shkatërrues (krijoni kopje të ndryshuar), duke mbështetur stilin e pandryshueshëm dhe funksional që gjithnjë e më shumë preferohet për kod më të sigurt dhe më të parashikueshëm.

Kuptimi i records — sintaksa e koncizë, barazimi me vlerë, pandryshueshmëria me `with`, dhe record structs — është i vlefshëm për të shkruar C# modern të pastër, pasi ato janë mënyra idiomatike për modelimin e të dhënave (DTOs, modelet e API, objektet e vlerës, gjendje e pandryshueshme) dhe përdoren gjerësisht në kodebases aktuale.

Dija se kur të përdorni një record (të dhëna të pandryshueshme me semantikë vlerash) versus një klasë (objekte të ndryshueshme me identitet dhe sjellje të pasur) pasqyron aftësinë me C# modern.

Për shkak se records thjeshtojnë ndjeshëm modelimin e të dhënave ndërsa ofrojnë barazim të saktë dhe pandryshueshmëri — nevoja të zakonshme që ishin të lodhshme dhe të prirur ndaj gabimeve përpara — ato janë një tipar i rëndësishëm, i përdorur shpesh që është shenja dalluese e kodit modern, të pastër të C#.