
This article was written in 2022. Versions, tools and recommendations may have changed since then. Newer posts are collected under .NET.
A NullReferenceException
is a common error that occurs in .NET applications when a null reference is accessed as if it were an object. This can happen when you attemp to call a method or access a property of a reference type variable that is null or when a null reference is passed as an argument to a method that expects a non-null object.
Here is an example of code that would throw a NullReferenceException:
1string name = null;
2int length = name.Length;In this example, the name variable is assigned a value of null and then we try to access its Length property. This results in a NullReferenceException because we are trying to access a property of an object that does not exist.
How to avoid NullReferenceExceptions
There are a few strategies you can use to avoid NullReferenceExceptions in your code:
Check for null values before attempting to access an object’s properties or methods. This can be done using an if statement or the null-coalescing operator (??) . For example:
1string name = null;
2int length = 0;
3
4if (name is not null)
5{
6 length = name.Length;
7}
8
9string name = null;
10int length = name?.Length ?? 0;Use the nullable type for value types. The nullable type allows value types to be assigned a value of null, which can be useful in cases where a value type may not always have a valid value. For example:
int? age = null;Use nullable reference types to help prevent null reference exceptions at compile time. In .NET 6 and later, nullable reference types can be used to help developers avoid null reference exceptions by providing compile-time warnings when a potentially null reference is dereferenced. For example:
1string? name = null;
2int length = name.Length; // Compile-time warning: Possible null reference exceptionBy using nullable reference types, developers can catch potential null reference exceptions before they occur at runtime.
Conclusion
NullReferenceExceptions can be frustrating to deal with, but they can be avoided by following best practices such as checking for null values, using the nullable type and leveraging nullable reference types. By doing so, developers can write more reliable and robust .NET code.
Related articles

- 16 min read
Production Rate Limiting in ASP.NET Core
Most ASP.NET Core rate-limiting examples stop after registering a fixed window. That is enough to demonstrate the middleware, but it is not …

- 11 min read
The Big Decimal Bugfix with .NET 11
For more than two decades, (decimal)1.23 returned 1.23m. It looked correct, it passed every test and it was a polite lie.

- 10 min read
Distroless, Chiseled or Alpine: Choosing a .NET Base Image
Distroless, Chiseled and Alpine are often compared as three equivalent Linux distributions. They are not. Alpine is a distribution built …
Let's Work Together
Looking for an experienced Platform Architect or Engineer for your next project? Whether it's cloud migration, platform modernization or building new solutions from scratch - I'm here to help you succeed.
