Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C#: record

Handbook C# · Practical Guide

Declares a type with generated comparison by value, formatting, and with support. record class — reference; record struct — value type.

Simple example (Example.cs)

Save this example separately as Example.cs. Run it independently of the other examples on this page.

Example.cs:

// PROJECT-EXAMPLE
var first = new Item("ore");
var second = new Item("ore");
System.Console.WriteLine(first == second);
record Item(string Name);

Result:

True

Syntax

record Person(string Name); / readonly record struct Point(int X, int Y);

Example 1: simple form

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        Person first = new("Archer");
        Person second = new("Archer");
        Console.WriteLine(first == second);
    }
}
public record Person(string Name);

Example 2: another practical form

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        Point start = new(2, 3);
        Point next = start with { X = 8 };
        Console.WriteLine($"{start} -> {next}");
    }
}
public readonly record struct Point(int X, int Y);

Official source: Microsoft Learn.