{"id":1408,"date":"2023-04-05T16:05:50","date_gmt":"2023-04-05T09:05:50","guid":{"rendered":"https:\/\/csharptutorial.net\/?page_id=1408"},"modified":"2023-06-16T19:08:48","modified_gmt":"2023-06-16T12:08:48","slug":"csharp-record","status":"publish","type":"page","link":"https:\/\/www.csharptutorial.net\/csharp-tutorial\/csharp-record\/","title":{"rendered":"C# Record"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you will learn about C# record that provides built-in functionality for encapsulating data.<\/p>\n\n\n\n

Introduction to C# record<\/h2>\n\n\n\n

C# record provides built-in functionality for encapsulating data, making it easy to work with immutable and strong-typed data.<\/p>\n\n\n\n

Records are immutable by default. It means that you cannot mutate (or change) their property values once created.<\/p>\n\n\n\n

Records have built-in support for value-based equality checking, meaning that two records with the same values are equal.<\/p>\n\n\n\n

Records provide default formatting, which can be customized by overriding the ToString()<\/code> method.<\/p>\n\n\n\n

Defining a Record<\/h3>\n\n\n\n

To define a record, you use the record<\/code> keyword with its properties:<\/p>\n\n\n

record RecordName<\/span>(type property1, type property2, ..<\/span>)<\/span>;<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
The following example demonstrates how to define a Person<\/code> record with three properties FirstName<\/code>, LastName<\/code>, and Age<\/code>:<\/p>\n\n\n
public<\/span> record Person<\/span>(string<\/span> FirstName, string<\/span> LastName, int<\/span> Age<\/span>)<\/span>;<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Creating a Record object<\/h3>\n\n\n\n
To create a new instance of a record, you can use the new<\/code> keyword followed by the name of the record and provide the values for its properties. For example:<\/p>\n\n\n
var<\/span> person = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 22<\/span>);<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
In this example, we created a new Person<\/code> record with the values \"John\"<\/code> for the FirstName<\/code> property, \"Doe\"<\/code> for the LastName<\/code> property, and 22<\/code> for the Age<\/code> property.<\/p>\n\n\n\n
Immutability<\/h3>\n\n\n\n
Records are immutable by default. The following attempts to change the Age<\/code> of the person<\/code> record and cause a compiled error:<\/p>\n\n\n
var<\/span> person = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 22<\/span>);\n\nperson.Age = 25<\/span>; \/\/ ERROR<\/span>\n\npublic<\/span> record Person(string FirstName, string LastName, int Age);<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Nondestructive mutation<\/h3>\n\n\n\n
If you want to copy a record with some modifications, you can use the with<\/code> expression. This is called a non-destructive mutation. <\/p>\n\n\n\n
The with<\/code> expression copies an existing record, with specified properties changed. For example:<\/p>\n\n\n
var<\/span> person = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 22<\/span>);\n\nvar<\/span> person2 = person with\n{\n    FirstName = \"Jane\"<\/span>,\n    Age = 20<\/span>\n};\n\nConsole.WriteLine(person2);\n\npublic<\/span> record Person<\/span>(string<\/span> FirstName, string<\/span> LastName, int<\/span> Age<\/span>)<\/span>;<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
Person { FirstName = Jane, LastName = Doe, Age = 20 }<\/code><\/span>Code language:<\/span> plaintext<\/span> (<\/span>plaintext<\/span>)<\/span><\/small><\/pre>\n\n\n
In this example, we use the with<\/code> expression to copy the person<\/code> record and change the FirstName<\/code> and Age<\/code> properties using the object initializer<\/a> syntax to specify the values to be changed.<\/p>\n\n\n\n
Value-based equality checking<\/h3>\n\n\n\n
Records have built-in value-based equality checking, which means that two records with the same values are considered equal. <\/p>\n\n\n\n
For example, if you create two Person<\/code> records with the same values, they are equal:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\nvar<\/span> person1 = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 30<\/span>);\nvar<\/span> person2 = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 30<\/span>);\n\nWriteLine(person1 == person2); \/\/ True<\/span>\n\npublic<\/span> record Person<\/span>(string<\/span> FirstName, string<\/span> LastName, int<\/span> Age<\/span>)<\/span>;<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
True<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Deconstruction record properties<\/h3>\n\n\n\n
You can deconstruct a record into its constituent properties. For example:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\nvar<\/span> person = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 2<\/span>);\nvar<\/span> (FirstName, LastName, Age) = person;\n\nWriteLine($\"FirstName: {FirstName}<\/span>, LastName: {LastName}<\/span>, Age: {Age}<\/span>\"<\/span>);\n\npublic<\/span> record Person<\/span>(string<\/span> FirstName, string<\/span> LastName, int<\/span> Age<\/span>)<\/span>;<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
FirstName: John, LastName: Doe, Age: 22<\/code><\/span>Code language:<\/span> plaintext<\/span> (<\/span>plaintext<\/span>)<\/span><\/small><\/pre>\n\n\n
Formatting<\/h3>\n\n\n\n
Records have built-in formatting capabilities that allow you to specify how they should be displayed as a string. Also, you can get a string representation of the record’s values by using the ToString()<\/code> method:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\nvar<\/span> person = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 22<\/span>);\n\nWriteLine(person);\n\npublic<\/span> record Person<\/span>(string<\/span> FirstName, string<\/span> LastName, int<\/span> Age<\/span>)<\/span>;<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
Person { FirstName = John, LastName = Doe, Age = 22 }<\/code><\/span>Code language:<\/span> plaintext<\/span> (<\/span>plaintext<\/span>)<\/span><\/small><\/pre>\n\n\n
By default, the ToString()<\/code> method uses the record’s name followed by its property names and values. In case you want to customize the formatting, you can override the ToString()<\/code> method like this:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\nvar<\/span> person = new<\/span> Person(\"John\"<\/span>, \"Doe\"<\/span>, 22<\/span>);\n\nWriteLine(person);\npublic<\/span> record Person<\/span>(string<\/span> FirstName, string<\/span> LastName, int<\/span> Age<\/span>)<\/span>\n{\n    public<\/span> override<\/span> string<\/span> ToString<\/span>(<\/span>)<\/span>\n        => $\"({FirstName}<\/span>,{LastName}<\/span>,{Age}<\/span>)\"<\/span>;\n}<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
(John,Doe,22)<\/code><\/span>Code language:<\/span> plaintext<\/span> (<\/span>plaintext<\/span>)<\/span><\/small><\/pre>\n\n\n
Defining mutable records<\/h2>\n\n\n\n
It’s possible to define a mutable record. For example:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\nvar<\/span> person = new<\/span> Person { \n    FirstName = \"John\"<\/span>, \n    LastName = \"Doe\"<\/span>, \n    Age = 22<\/span> \n};\n\nperson.Age = 25<\/span>; \/\/ OK<\/span>\nperson.LastName = \"Smith\"<\/span>; \/\/ OK<\/span>\n\nWriteLine(person );\n\npublic<\/span> record Person\n{\n    public<\/span> string<\/span> FirstName { get<\/span>; set<\/span>;}\n    public<\/span> string<\/span> LastName  { get<\/span>; set<\/span>;} \n    public<\/span> int<\/span> Age { get<\/span>; set<\/span>;}\n}<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
Person { FirstName = John, LastName = Smith, Age = 25 }<\/code><\/span>Code language:<\/span> plaintext<\/span> (<\/span>plaintext<\/span>)<\/span><\/small><\/pre>\n\n\n
C# Record applications<\/h2>\n\n\n\n
In practice, you can use the C# record in the following scenarios:<\/p>\n\n\n\n
    \n
  • API response models:<\/strong> you can use records to represent response models in RESTful APIs. In this case, you can define the record with the properties that correspond to the data being returned by the API. Records help deserialize the response into a strongly-typed object easily and work with the data more simply.<\/li>\n\n\n\n
  • Configuration settings:<\/strong> you can use records to represent configuration settings for an application. In this case, you define a record with the properties that correspond to the various settings of the application. This allows you to pass the settings around between methods and services easily while enforcing the immutability of the settings.<\/li>\n\n\n\n
  • Domain models:<\/strong> you can use records to represent domain models in an application. In this scenario, you define a record with properties that correspond to the data being modeled. Records allow you to easily work with the data in a strongly-typed and immutable way. Also, you can take advantage of the built-in equality checking and formatting capabilities of records.<\/li>\n<\/ul>\n\n\n\n
    Summary<\/h2>\n\n\n\n
      \n
    • C# record is a reference type that provides built-in functionality for encapsulating data.<\/li>\n\n\n\n
    • Use C# records in API response models, configuration settings, and domain models.<\/li>\n<\/ul>\n
      \n\t
      \n\t\t
      Was this tutorial helpful ?<\/div>\n\t\t
      \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
      \n\t\t
      \n\t\t\t
      <\/div>\n\t\t\t\n\t\t\t