Record declaration syntax in C Sharp (C#)

Introduction

Records help you create simple, immutable data containers easily. They automatically provide useful features like value equality and readable string output.

When you want to store data that should not change after creation, like a person's name and age.

When you need to compare two data objects by their content, not by their location in memory.

When you want a simple way to print or log data objects with clear information.

When you want to create data objects quickly without writing lots of code for properties and methods.

Syntax

C Sharp (C#)

public record RecordName(Type1 Property1, Type2 Property2, ...);

Records are immutable by default, meaning their properties cannot be changed after creation.

You can also declare records with a body to add methods or additional properties.

Examples

This declares a record named Person with two properties: Name and Age.

C Sharp (C#)

public record Person(string Name, int Age);

A simple record to hold coordinates X and Y.

C Sharp (C#)

public record Point(int X, int Y);

This shows a record declared with a body, using init properties for immutability.

C Sharp (C#)

public record Car
{
    public string Make { get; init; }
    public string Model { get; init; }
}

Sample Program

This program creates three Person records. It shows how records print nicely and how equality compares their content.

C Sharp (C#)

using System;

public record Person(string Name, int Age);

class Program
{
    static void Main()
    {
        var person1 = new Person("Alice", 30);
        var person2 = new Person("Alice", 30);
        var person3 = new Person("Bob", 25);

        Console.WriteLine(person1); // Prints the record's data
        Console.WriteLine(person1 == person2); // True because values are equal
        Console.WriteLine(person1 == person3); // False because values differ
    }
}

Important Notes

Records provide built-in ToString(), Equals(), and GetHashCode() methods based on their properties.

Use init accessors to keep properties immutable after creation.

Summary

Records are simple, immutable data holders with automatic features.

Use the concise syntax with parentheses to declare properties quickly.

Records compare by value, not by reference, making them great for data equality.

Practice

1. What is a key feature of a record in C#?

easy

A. It provides immutable data with value-based equality.

B. It allows mutable fields by default.

C. It is used only for database connections.

D. It cannot have properties.

Solution

1. Step 1: Understand what a record is

   A record is a special type in C# designed to hold data immutably.

2. Step 2: Identify the main feature

   Records compare by value, not by reference, and are immutable by default.

3. Final Answer:

   It provides immutable data with value-based equality. -> Option A

4. Quick Check:

   Record = Immutable + Value Equality [OK]

Hint: Remember: records are immutable and compare by value [OK]

Common Mistakes:

• Thinking records are mutable by default
• Confusing records with classes for database use
• Believing records cannot have properties

2. Which of the following is the correct syntax to declare a record with two properties int Id and string Name?

easy

A. record Person { int Id; string Name; }

B. record Person(int Id, string Name);

C. record Person = (int Id, string Name);

D. record Person(int Id; string Name);

Solution

1. Step 1: Recall record declaration syntax

   Records use parentheses with comma-separated parameters for properties.

2. Step 2: Check each option

   record Person(int Id, string Name); uses correct syntax: parentheses and commas. record Person { int Id; string Name; } uses braces without property syntax. record Person = (int Id, string Name); uses '=' incorrectly. record Person(int Id; string Name); uses semicolon instead of comma.

3. Final Answer:

   record Person(int Id, string Name); -> Option B

4. Quick Check:

   Record syntax = parentheses + commas [OK]

Hint: Use parentheses with commas for record properties [OK]

Common Mistakes:

• Using braces instead of parentheses
• Using semicolons instead of commas
• Adding '=' sign incorrectly

3. What will be the output of the following code?

record Point(int X, int Y);
var p1 = new Point(3, 4);
var p2 = new Point(3, 4);
Console.WriteLine(p1 == p2);

medium

A. True

B. False

C. Compilation error

D. Runtime exception

Solution

1. Step 1: Understand record equality behavior

   Records compare by value, so two records with same property values are equal.

2. Step 2: Analyze the code

   p1 and p2 have same X and Y values (3,4), so p1 == p2 returns true.

3. Final Answer:

   True -> Option A

4. Quick Check:

   Records compare by value = True [OK]

Hint: Records compare by value, so identical values mean equality [OK]

Common Mistakes:

• Assuming reference equality instead of value equality
• Expecting false because of different instances
• Thinking it causes a compilation error

4. Identify the error in this record declaration:

record Car(string Make, string Model)
{
    public int Year;
}

medium

A. Records cannot have any fields declared inside braces.

B. The semicolon is missing after the record declaration.

C. The record must use parentheses for properties, not braces.

D. Fields inside records must be declared as properties, not fields.

Solution

1. Step 1: Understand record members

   Records can have members, but fields should be properties for immutability.

2. Step 2: Analyze the code

   The code declares a public field 'Year' instead of a property, which is not recommended and causes issues.

3. Final Answer:

   Fields inside records must be declared as properties, not fields. -> Option D

4. Quick Check:

   Use properties, not fields inside records [OK]

Hint: Use properties, not fields, inside records for immutability [OK]

Common Mistakes:

• Using fields instead of properties inside records
• Missing semicolon after record declaration (not required here)
• Confusing braces and parentheses usage

5. You want to declare a record Book with properties string Title, string Author, and an optional int? Year that defaults to null. Which is the correct way to declare it?

hard

A. record Book { string Title; string Author; int? Year = null; }

B. record Book(string Title, string Author, int? Year);

C. record Book(string Title, string Author, int? Year = null);

D. record Book(string Title, string Author) { public int? Year = null; }

Solution

1. Step 1: Use concise record syntax with default parameter

   Records allow default values in the parameter list using '='.

2. Step 2: Check each option

   record Book(string Title, string Author, int? Year = null); correctly declares Year as nullable with default null. record Book(string Title, string Author, int? Year); lacks default. record Book { string Title; string Author; int? Year = null; } uses invalid field syntax. record Book(string Title, string Author) { public int? Year = null; } uses field with default inside braces, which is not idiomatic.

3. Final Answer:

   record Book(string Title, string Author, int? Year = null); -> Option C

4. Quick Check:

   Default values go in parentheses parameters [OK]

Hint: Set default values inside parentheses in record declarations [OK]

Common Mistakes:

• Omitting default value for optional parameters
• Using fields instead of properties inside braces
• Trying to assign default values inside braces