Kaj so zapisi v C#?

Question

Kaj so zapisi v C#?

Accepted Answer

**Zapisi** (C# 9+) so koncizen način za definiranje tipov, ki so primarno **nespremenljivi prenosniki podatkov** s **primerjavo temelječo na vrednosti**. Samodejno generirajo boilerplate (konstruktor, enakost, `ToString`, itd.), kar jih naredi idealne za DTO-je, domenske vrednosti in modeliranje podatkov.

## Definiranje zapisa (pozicijska sintaksa)

```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
```

Pozicijska sintaksa `record Person(string Name, int Age)` generira vse — lastnosti, konstruktor, `ToString`, enakost, dekonstrukcijo — kar odpravi boilerplate, ki bi ga zahtevala navadna razred.

## Primerjava temelječa na vrednosti (ključna razlika od razredov)

```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)
```

Za razliko od razredov (ki primerjajo po identiteti reference), zapisi primerjajo po **vrednosti** — dva zapisa z enakimi vrednostmi lastnosti sta enaka. To je natanko tisto, kar želiš za podatkovne objekte.

## Nespremenljivost in nedestruktivna mutacija (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 }
```

Zapisi so privzeto nespremenljivi, in **`with` izraz** ustvari spremenjeno kopijo (nedestruktivna mutacija) — idealno za delo z nespremenljivimi podatki.

## 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)
```

## Zakaj je to pomembno

Zapisi so pomembna sodobna C# funkcija (C# 9+), ki naredi definiranje nespremenljivih podatkovnih tipov koncizno in pravilno, zato je njihovo razumevanje vrednostno za sodobni C# razvoj.

Their key benefits address real needs: they **eliminate boilerplate** (auto-generating constructors, properties, `ToString`, equality, and deconstruction from a one-line declaration — versus the substantial code a regular class requires), and they provide **value-based equality** (two records with equal properties are equal, unlike classes which compare by reference) — which is exactly the behavior you want for data objects, DTOs, and domain values, and which classes get wrong by default.

Zapisi so tudi **privzeto nespremenljivi** z elegantnim **`with` izrazom** za nedestruktivno mutacijo (ustvarjanje spremenjenih kopij), kar podpira nespremenljiv, funkcionalen slog, ki je vedno bolj priljubljen za varnejšo, bolj napovedljivo kodo.

Razumevanje zapisov — koncizna sintaksa, vrednostna enakost, nespremenljivost z `with` in strukture zapisov — je vrednostno za pisanje čiste sodobne C#, saj so idiomatičen način za modeliranje podatkov (DTO-ji, API modeli, vrednostni objekti, nespremenljivo stanje) in so široko uporabljeni v sedanjih kodnih bazah.

Znanje, kdaj uporabiti zapis (nespremenljivi podatki s semantiko vrednosti) v primerjavi s razredom (spremenljivi objekti z identiteto in bogatim vedenjem) kaže tekoče znanje sodobne C#.

Ker zapisi dramatično poenostavijo modeliranje podatkov in hkrati zagotavljajo pravilno enakost in nespremenljivost — običajne potrebe, ki so bile pred tem dolgočasne in nagnjene k napakam — so pomembna, pogosto uporabljena funkcija, ki je znamenitost sodobne, čiste C# kode.