{"id":103761,"date":"2024-01-01T04:56:13","date_gmt":"2024-01-01T03:56:13","guid":{"rendered":"https:\/\/code-maze.com\/?p=103761"},"modified":"2024-01-01T04:56:13","modified_gmt":"2024-01-01T03:56:13","slug":"csharp-record-parameter-initialization","status":"publish","type":"post","link":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/","title":{"rendered":"How to Initialize Parameters of a Record in C#"},"content":{"rendered":"

In this article, we are going to learn how to initialize the parameters of a record type in C#. For an overview of what records are, have a look at this article<\/a>.<\/p>\n

To download the source code for this article, you can visit our GitHub repository<\/a>.<\/div>\n

So, let’s dive in.<\/p>\n

<\/a>How to Initialize Parameters of a Record<\/h2>\n

Let’s assume we declare a simple record with two parameters. We use the constructor to set the value of the parameters:<\/p>\n

public record Person\r\n{\r\n    public string FirstName { get; set; }\r\n    public string LastName { get; set; }\r\n\r\n    public Person(string firstName, string lastName)\r\n    {\r\n        FirstName = firstName;\r\n        LastName = lastName;\r\n    }\r\n}<\/pre>\n
The syntax to declare the record is very similar to how we would declare a class<\/strong> but uses the record<\/code> keyword instead of class<\/code>. To initialize the parameters of the Person<\/code> record, the syntax is also similar to initializing those in a class:<\/p>\n
var person = new Person(\"Joe\", \"Bloggs\");<\/code><\/p>\n
<\/a>How to Initialize Parameters of a Record Using Positional Parameters<\/h2>\n
In the previous example, the properties of the record were mutable. One of the reasons to use records is that their properties can be immutable<\/strong> using the init<\/code> keyword. This means we can only set the value of a property during construction:<\/p>\n
public\u00a0string\u00a0FirstName\u00a0{\u00a0get;\u00a0init;\u00a0}\r\npublic string LastName { get; init; }<\/pre>\n
Alternatively, we can achieve the same with a single line of code using the<\/strong> primary constructor<\/a>:<\/p>\n
public record Person(string FirstName, string LastName);<\/code><\/p>\n
When we use a primary constructor with a record that has parameters, the compiler creates an immutable backing public property for each of our parameters.<\/strong> We call these parameters positional parameters<\/strong>.<\/p>\n
It might look slightly unusual that the parameters have Pascal case, not Camel case. This is intentional though, since the compiler will use the exact case of the parameters to generate the backing properties. So if we want to maintain Pascal case properties, we need to use Pascal case parameters.<\/p>\n
To instantiate the record, we use the same syntax:<\/p>\n
var person = new Person(\"Joe\", \"Bloggs\");<\/code><\/p>\n
<\/a>A More Advanced Example With a Default Value<\/h2>\n
Now, let’s see what happens if we add an optional parameter<\/strong> called friends to our Person<\/code> record:<\/p>\n
public record Person \r\n{ \r\n    public string FirstName { get; set; }\r\n    public string LastName { get; set; }\r\n    public IEnumerable<string> Friends { get; set; }\r\n\r\n    public Person(string firstName, string lastName, IEnumerable<string>? friends = null)\r\n    { \r\n        FirstName = firstName; \r\n        LastName = lastName;\r\n        Friends = friends ?? new List<string>();\r\n    }\r\n}<\/pre>\n
In this case, if the person has some friends, we can pass this into the constructor when instantiating the record:<\/p>\n
var person = new Person(\"Joe\", \"Bloggs\", new List<string> { \"Alice\", \"Bob\"});<\/code><\/p>\n
We set the Friends<\/code> property in our constructor. If the person has no associated friends, we can either pass a null<\/code> into the constructor or omit it completely since it is an optional parameter. In this case, the Friends<\/code> property is set to an empty list in the constructor.<\/p>\n
However, again there is a much more concise way of declaring our record type using a primary constructor:<\/strong><\/p>\n
public record Person(string FirstName, string LastName, IEnumerable<string>? Friends = null)\r\n{\r\n    public IEnumerable<string> Friends { get; init; } = Friends ?? new List<string>();\r\n};<\/pre>\n
The FirstName<\/code> and LastName<\/code> properties are generated by the compiler as we saw before. With the Friends<\/code> parameter, the compiler would normally create a backing property for us, with the default value of null<\/code>, not an empty list.<\/p>\n
Instead, we can create the property ourselves and ensure it is set to an empty list if Friends<\/code> is null<\/code>. We also make it immutable by using the init<\/code> keyword.<\/p>\n
<\/a>Conclusion<\/h2>\n
We initialize parameters for a record<\/code> type in a similar way to how we initialize parameters for classes.<\/p>\n
We have also seen that the compiler automatically creates properties when we use a primary constructor with records which can simplify our code. Finally, we have seen how we set a default value for a property in a more complicated case.<\/p>\n","protected":false},"excerpt":{"rendered":"
In this article, we are going to learn how to initialize the parameters of a record type in C#. For an overview of what records are, have a look at this article. So, let’s dive in. How to Initialize Parameters of a Record Let’s assume we declare a simple record with two parameters. We use […]<\/p>\n","protected":false},"author":6,"featured_media":62189,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[12],"tags":[10,1811,2026,988],"class_list":["post-103761","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-csharp","tag-net","tag-c","tag-record-parameter-initialization","tag-records","et-has-post-format-content","et_post_format-et-post-format-standard"],"yoast_head":"\nHow to Initialize Parameters of a Record in C# - Code Maze<\/title>\n<meta name=\"description\" content=\"This article will cover how to initialize parameters of the record with simple parameters and the record with optional parameters in C#.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Initialize Parameters of a Record in C# - Code Maze\" \/>\n<meta property=\"og:description\" content=\"This article will cover how to initialize parameters of the record with simple parameters and the record with optional parameters in C#.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/\" \/>\n<meta property=\"og:site_name\" content=\"Code Maze\" \/>\n<meta property=\"article:published_time\" content=\"2024-01-01T03:56:13+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1100\" \/>\n\t<meta property=\"og:image:height\" content=\"620\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Code Maze\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@https:\/\/twitter.com\/CodeMazeBlog\" \/>\n<meta name=\"twitter:site\" content=\"@CodeMazeBlog\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Code Maze\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":[\"Article\",\"BlogPosting\"],\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/\"},\"author\":{\"name\":\"Code Maze\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/person\/09d29b223012c8e94a68ba62861d0b04\"},\"headline\":\"How to Initialize Parameters of a Record in C#\",\"datePublished\":\"2024-01-01T03:56:13+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/\"},\"wordCount\":515,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/code-maze.com\/#organization\"},\"image\":{\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png\",\"keywords\":[\".NET\",\"C#\",\"record parameter initialization\",\"Records\"],\"articleSection\":[\"C#\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/\",\"url\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/\",\"name\":\"How to Initialize Parameters of a Record in C# - Code Maze\",\"isPartOf\":{\"@id\":\"https:\/\/code-maze.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png\",\"datePublished\":\"2024-01-01T03:56:13+00:00\",\"description\":\"This article will cover how to initialize parameters of the record with simple parameters and the record with optional parameters in C#.\",\"breadcrumb\":{\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage\",\"url\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png\",\"contentUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png\",\"width\":1100,\"height\":620,\"caption\":\"C# Development\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/code-maze.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Initialize Parameters of a Record in C#\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/code-maze.com\/#website\",\"url\":\"https:\/\/code-maze.com\/\",\"name\":\"Code Maze\",\"description\":\"Learn. Code. Succeed.\",\"publisher\":{\"@id\":\"https:\/\/code-maze.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/code-maze.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/code-maze.com\/#organization\",\"name\":\"Code Maze\",\"url\":\"https:\/\/code-maze.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png\",\"contentUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png\",\"width\":3511,\"height\":3510,\"caption\":\"Code Maze\"},\"image\":{\"@id\":\"https:\/\/code-maze.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/x.com\/CodeMazeBlog\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/person\/09d29b223012c8e94a68ba62861d0b04\",\"name\":\"Code Maze\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez-150x150.png\",\"contentUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez-150x150.png\",\"caption\":\"Code Maze\"},\"description\":\"This is the standard author on the site. Most articles are published by individual authors, with their profiles, but when several authors have contributed, we publish collectively as a part of this profile.\",\"sameAs\":[\"https:\/\/www.linkedin.com\/company\/codemaze\/\",\"https:\/\/x.com\/https:\/\/twitter.com\/CodeMazeBlog\"],\"url\":\"https:\/\/code-maze.com\/author\/codemazecontributor\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Initialize Parameters of a Record in C# - Code Maze","description":"This article will cover how to initialize parameters of the record with simple parameters and the record with optional parameters in C#.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/","og_locale":"en_US","og_type":"article","og_title":"How to Initialize Parameters of a Record in C# - Code Maze","og_description":"This article will cover how to initialize parameters of the record with simple parameters and the record with optional parameters in C#.","og_url":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/","og_site_name":"Code Maze","article_published_time":"2024-01-01T03:56:13+00:00","og_image":[{"width":1100,"height":620,"url":"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png","type":"image\/png"}],"author":"Code Maze","twitter_card":"summary_large_image","twitter_creator":"@https:\/\/twitter.com\/CodeMazeBlog","twitter_site":"@CodeMazeBlog","twitter_misc":{"Written by":"Code Maze","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":["Article","BlogPosting"],"@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#article","isPartOf":{"@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/"},"author":{"name":"Code Maze","@id":"https:\/\/code-maze.com\/#\/schema\/person\/09d29b223012c8e94a68ba62861d0b04"},"headline":"How to Initialize Parameters of a Record in C#","datePublished":"2024-01-01T03:56:13+00:00","mainEntityOfPage":{"@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/"},"wordCount":515,"commentCount":0,"publisher":{"@id":"https:\/\/code-maze.com\/#organization"},"image":{"@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage"},"thumbnailUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png","keywords":[".NET","C#","record parameter initialization","Records"],"articleSection":["C#"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/","url":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/","name":"How to Initialize Parameters of a Record in C# - Code Maze","isPartOf":{"@id":"https:\/\/code-maze.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage"},"image":{"@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage"},"thumbnailUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png","datePublished":"2024-01-01T03:56:13+00:00","description":"This article will cover how to initialize parameters of the record with simple parameters and the record with optional parameters in C#.","breadcrumb":{"@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/code-maze.com\/csharp-record-parameter-initialization\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#primaryimage","url":"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png","contentUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2021\/12\/social-csharp.png","width":1100,"height":620,"caption":"C# Development"},{"@type":"BreadcrumbList","@id":"https:\/\/code-maze.com\/csharp-record-parameter-initialization\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/code-maze.com\/"},{"@type":"ListItem","position":2,"name":"How to Initialize Parameters of a Record in C#"}]},{"@type":"WebSite","@id":"https:\/\/code-maze.com\/#website","url":"https:\/\/code-maze.com\/","name":"Code Maze","description":"Learn. Code. Succeed.","publisher":{"@id":"https:\/\/code-maze.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/code-maze.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/code-maze.com\/#organization","name":"Code Maze","url":"https:\/\/code-maze.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/code-maze.com\/#\/schema\/logo\/image\/","url":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png","contentUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png","width":3511,"height":3510,"caption":"Code Maze"},"image":{"@id":"https:\/\/code-maze.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/CodeMazeBlog"]},{"@type":"Person","@id":"https:\/\/code-maze.com\/#\/schema\/person\/09d29b223012c8e94a68ba62861d0b04","name":"Code Maze","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/code-maze.com\/#\/schema\/person\/image\/","url":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez-150x150.png","contentUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez-150x150.png","caption":"Code Maze"},"description":"This is the standard author on the site. Most articles are published by individual authors, with their profiles, but when several authors have contributed, we publish collectively as a part of this profile.","sameAs":["https:\/\/www.linkedin.com\/company\/codemaze\/","https:\/\/x.com\/https:\/\/twitter.com\/CodeMazeBlog"],"url":"https:\/\/code-maze.com\/author\/codemazecontributor\/"}]}},"_links":{"self":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts\/103761","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/comments?post=103761"}],"version-history":[{"count":2,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts\/103761\/revisions"}],"predecessor-version":[{"id":103763,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts\/103761\/revisions\/103763"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/media\/62189"}],"wp:attachment":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/media?parent=103761"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/categories?post=103761"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/tags?post=103761"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}