Įrašai (C# 9+) yra glausta priemonė apibrėžti tipos, kurie pirmiausia yra nekeičiami duomenų nešiotojai su reikšme pagrįsta lygybe. Jie automatiškai generuoja standartinį kodą (konstruktorius, lygybę, ToString ir kt.), todėl jie idealūs DTO, domeno reikšmėms ir duomenų modeliavimui.
;
p1 = Person(, );
p1.Name;
Console.WriteLine(p1);
Pozicinis sintaksė record Person(string Name, int Age) generuoja viską — savybes, konstruktorių, ToString, lygybę, dekonstrukciją — pašalinant standartinį kodą, kurio reikalautų įprastinė klasė.
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)
Skirtingai nuo klasių (kurios lygina pagal nuorodų tapatybę), įrašai lygina pagal reikšmę — du įrašai su tomis pačiomis savybių reikšmėmis yra lygūs. Tai yra tiksliai tai, ko reikia duomenų objektams.
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 }
Įrašai yra nekeičiami pagal numatytas, o with išraiška sukuria modifikuotą kopiją (nesurusiantis keitimas) — idealus darbui su nekeičiamais duomenimis.
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)
Įrašai yra svarbi šiuolaikinė C# funkcija (C# 9+), kuri nekeičiamų duomenų tipų apibrėžimą daro glaustą ir teisingą, todėl jų supratimas vertingas šiuolaikiniam C# vystymuisi.
Jų pagrindiniai privalumai atitinka tikrus poreikius: jie pašalina standartinį kodą (automatiškai generuoja konstruktorius, savybes, ToString, lygybę ir dekonstrukciją iš vienos eilutės deklaracijos — priešingai nei reikšmingas kodas, kurio reikalautų įprastinė klasė), ir jie suteikia reikšme pagrįstą lygybę (du įrašai su lygiomis savybėmis yra lygūs, skirtingai nuo klasių, kurios lygina pagal nuorodas) — tai yra tiksliai elgesys, kurio norite duomenų objektams, DTO ir domeno reikšmėms, ir kurio klasės pagal numatytas nesuteikia.
Įrašai taip pat yra nekeičiami pagal numatytas su elegantiška with išraiška nesurusiantiems keitimams (kuriama modifikuotos kopijos), palaikydami nekeičiamą, funkcinį stilių, kuris vis dažniau vertinamas saugesniems, labiau nuspėjamiems kodui.
Supratimas apie įrašus — glaustas sintaksę, reikšmės lygybę, nekeitimą su with ir struktūriniais įrašais — vertingas kuriant šviesą šiuolaikinį C#, nes jie yra idiomine priemonė duomenims modeliuoti (DTO, API modelius, reikšmės objektus, nekeičiamą būseną) ir plačiai naudojami dabartiniuose kodų bazėse.
Žinojimas, kada naudoti įrašą (nekeičiamus duomenis su reikšmės semantika) prieš klasę (keičiamus objektus su tapatybe ir turtinga elgsena) atspindi sugebėjimą naudoti šiuolaikinį C#.
Kadangi įrašai dramatiškai supaprastina duomenų modeliavimą suteikdami teisingą lygybę ir nekeitimą — bendrus poreikius, kurie buvo nuobodūs ir pasklydžiūs anksčiau — jie yra svarbi, dažnai naudojama funkcija, kuri yra šiuolaikinio, šviesaus C# kodo ženklas.