Primary Constructors (C# 12 Syntactic Sugar): A Guide 

February 8, 2024

With the introduction of .Net8 and C#12 in November of 2023, there were many significant changes to .NET and C#. One such feature in C#12 is the concept of a Primary Constructor. A Primary constructor replaces a class constructor with parameters on the class. The parameters for the constructor are available anywhere in the body of the class.  

With Primary Constructor: 

Primary Constructors

It is important to note that the class parameters are not fields of the class. The following code will not compile if used in SimpleClass, as foo and bar are not available on “this”. 

Primary Constructors

Using a Primary Constructor can significantly improve the readability of your code, as it does away with a lot of the code infrastructure around class constructors. For example, compare how much easier to read SimpleClass is, to functionally equivalent class that does not use a Primary Constructor. 

Without Primary Constructor: 

Primary Constructors

Primary Constructors can also be used on types of “struct” and “record”.  This can make creating and maintaining DTO’s easier to do. For example. 

Primary Constructors

We suggest keeping the following in mind when using a Primary Constructor: 

Class parameters are not directly available to child classes. Thus, the following code will not compile, as bar and foo are not available to the child class, SimpleChildClass. 

Primary Constructors

If you wish to override the constructor, the class parameters must be included. To include the class parameters, you must use this() on the overridden constructor. If your class has multiple constructor overrides, using a primary constructor may not be the best solution. 

Primary Constructors

The Class parameters are not read-only fields. If you are using these parameters directly with dependency injection, it is possible to cause side effects that will cause runtime errors. For example: 

Primary Constructors

If FooUp() is called before FooBar(), then a NullReferenceException will be thrown by FooBar(). It is better to use a read-only field in conjunction with the Primary Constructor. 

Primary Constructors

This class will not compile because _logger is read-only and FooUp cannot assign a value to _logger, thus preventing FooBar from throwing a NullReferenceException. 
 
Primary constructors are a neat bit of syntactic sugar that has been added to C#12, which has the promise of making your classes a bit easier to read and saving some repetitive constructor code. They are not suitable for every situation, however, and care must be used when using these parameters in your code. 
 
The developers at Imaginet are passionate about what they do. They are extremely well-versed in all areas of coding and application development. When was the last time you updated your applications? From this blog, we can see how change comes quickly, which means applications can become out of date quickly. Staying ahead of these changes is essential to maintaining proper performance of your applications.  

For more information about Primary Constructors, check out this helpful Microsoft Learn Tutorial.
 
If your applications are out of date, fill out the form below and someone will be in touch. Make sure to follow our blog, where we publish technology tips, tricks, and updates every week.  

Software Development Trends

Discover More

Industry 4.0 Benefits

Industry 4.0 Benefits – Part 2

Darren KuikNov 21, 20243 min read

Industry 4.0 Benefits – Part 2   November 14, 2024 In part two of the Industry 4.0 blog series let’s look at a few of the great benefits of adoption. More…

Industry 4.0

Industry 4.0 – Part 1 – The History 

Darren KuikNov 14, 20243 min read

Industry 4.0 – Part 1 – The History   November 14, 2024 What is Industry 4.0 Industry 4.0 is a term that has been around for about a decade already. Also…

SharePoint Look Book

SharePoint Look Book: A Hidden Design Gem 

Jesse DyckNov 7, 20243 min read

SharePoint Look Book: A Hidden Design Gem     November 7, 2024 SharePoint Look Book: A Hidden Design Gem In the world of digital collaboration, SharePoint stands tall in helping organizations enhance…

Let’s build something amazing together

From concept to handoff, we’d love to learn more about what you are working on.
Send us a message below or call us at 1-800-989-6022.