C# / .NET Kompendium PLEN
.NET / C# / C# — fundamenty języka

Różnica między struct a record

To pytanie miesza dwie osie

struct i record odpowiadają na dwa różne pytania: - struct vs class - pytanie o semantykę pamięciową (typ wartościowy vs referencyjny) - record vs zwykła deklaracja - pytanie o semantykę równości

record to NIE jest alternatywa dla struct - to modyfikator, którego możesz użyć razem z class (domyślnie) albo razem z struct (jawnie, przez record struct).

Cztery kombinacje, nie dwie

public class OrderClass { }               // typ referencyjny, równość przez referencję
public record OrderRecord { }             // typ referencyjny (!), równość przez wartość
public struct PointStruct { }             // typ wartościowy, równość przez wartość (ale ręcznie/refleksja)
public record struct PointRecordStruct { } // typ wartościowy, równość przez wartość (generowana)

record bez dopisku struct domyślnie generuje class.

public record OrderRecord(int Id); // to jest DE FACTO klasa!

OrderRecord r1 = new OrderRecord(1);
OrderRecord r2 = r1;
// r1 i r2 to WCIĄŻ dwie referencje do TEGO SAMEGO obiektu na stercie (jak przy class)
// ALE r1 == r2 zwróci true niezależnie, bo to porównanie WARTOŚCIOWE, nie referencyjne

Porównanie "czystego" struct z "czystym" record

struct record (= record class)
Typ pamięciowy Wartościowy (stos/inline) Referencyjny (sterta)
Kopiowanie przy przypisaniu Kopiuje CAŁY obiekt Kopiuje tylko referencję
Domyślna równość Porównanie pól przez refleksję (wolne!) w ValueType.Equals Wygenerowany, wydajny kod porównujący pola
Może być null Nie Tak
Dziedziczenie Nie Tak
with expression Nie Tak

Zaskakujący fakt: zwykły struct też ma "równość po wartości" w pewnym sensie:

public struct PointStruct { public int X; public int Y; }

var p1 = new PointStruct { X = 1, Y = 2 };
var p2 = new PointStruct { X = 1, Y = 2 };
p1.Equals(p2); // true - ALE przez refleksję, WOLNE (ValueType.Equals używa reflection)

record struct rozwiązuje dokładnie ten problem wydajnościowy.

record struct - gdzie te dwie koncepcje się łączą

public record struct PointRecordStruct(int X, int Y);
var p1 = new PointRecordStruct(1, 2);
var p2 = p1; // KOPIUJE (struct)
p2.X = 100; // MOŻNA zmieniać - record struct BEZ readonly nie jest init-only

Console.WriteLine(p1.X); // 1 - niezmienione
var p3 = p1 with { X = 100 }; // "with" działa też dla record struct

Ważna różnica względem record class: record struct domyślnie NIE jest init-only - właściwości mają { get; set; }, nie { get; init; } (chyba że dodasz readonly record struct). To jest odwrotność tego, co dzieje się w record class.

public record struct MutablePoint(int X, int Y); // set, MOŻNA zmieniać po utworzeniu
public readonly record struct ImmutablePoint(int X, int Y); // init, niemutowalne, jak record class

Praktyczna reguła

Potrzebujesz reprezentować DANE (nie zachowanie/tożsamość)?
├── Małe (≤16 bajtów), wartość jak prymityw (Point, Money, współrzędne)?
│   └── record struct (najlepsze z obu światów)
├── Większe dane, DTO, Command/Query (CQRS)?
│   └── record (= record class)
└── Potrzebujesz mutowalnego stanu z tożsamością (encja EF, ViewModel, serwis)?
    └── zwykła class
Postaw mi kawę