It is a very common practice to check for null in parameters: { (foo ) { ArgumentNullException( (foo)); } } ( ) public void DoSomething Foo foo if is null throw new nameof In this blog, I want to talk about parameter null validation: why, when, and how. Why It's suggested in many coding style rules, it's followed in many open source projects, but why? What would happen if we don't check the parameters? What's the benefit of parameters null validation? Let's talk about the following C# code: { (car == ) { ArgumentNullException( (foo)); } Console.WriteLine(car.Name); } ( ) public void PrintCar Car car if null throw new nameof In this case, if we don't check whether the parameter is null, it will raise a NullReferenceException; if we check the parameter, it will raise a ArgumentNullException. It looks like the NullReferenceException is missing, but actually we get a new ArgumentNullException. The caller still have to handle it. The number of exceptions doesn't change at all. Referring to Voldemort as "You-Know-Who" cannot kill him. If a method catches an exception and doesn't has the ability to handle it, is it needed to check the null parameters? Different people have different opinions. In the blog , the author made a point that it doesn't make sense if you catch the exception and ignore it. The bug needs to be visible to be easily corrected. <Why I Never Null-Check Parameters> In my opinion, parameters null validation is necessary and useful in most cases. The first reason is that, is different from . The name of exceptions can help us find the responsible party. If you call the method and you get a , you may figure out there is something wrong with the parameters. Just like 40x and 50x status code in HTTP. is totally different from . NullReferenceException ArgumentNullException ArgumentNullException Bad Request Server Error The second reason is that, most methods in our service are not stateless. In these stateful methods, an exception in the middle of the method will mess the states up and we cannot roll back easily. Take a look at this example: { .CarCount += ; .CarNames.Add(car.Name); } ( ) public void CarCounter Car car // #1 this 1 // #2 this When car is null, it will raise an exception in line #2. However, there is a state update in line #1. This may modify the count incorrectly. We need a mechanism like transaction in DB to roll back the executed part of the method. It may be very complicated. And for some cases like notification, the actions are irrevocable. As a conclusion, in most cases parameter null validation is necessary and useful. It can avoid the execution which shouldn't happen, and it can specify the responsibility of the unexpected exception. When As we talked above, it's meaningful to check the null parameters. But should we check all method parameters in our projects? It depends. For public method, we don't know what parameters the caller will pass, we should check null parameters before the business logic. For private methods, we needn't check because we are supposed to know how and where this method is called. In this situation, the null variables should be checked outside of the method before calling it. It's a good choice to enable the . With this warning, we needn't care about when to validate the parameters. Just think about which access modifier should be used, public or private. CA1062 Warning How The following question is, how to check null parameters. The code for validation is verbose and useless. Validate null parameters every where will make the code less human-readable. In the blog , the author went through many ways to validate the parameters. The about bang operator is very interesting and I am really looking forward to it. <C# Futures: Simplified Parameter Null Validation> C# Proposal #2145 Given the Code Contract is , wrapping the validation into a Helper is a better choice: deprecated { { IsNull<T>(T argument, name) { (argument ) { ArgumentNullException(name); } } } } { ThrowIf.Argument.IsNull(foo, (foo)); } internal static class ThrowIf public static class Argument public static void string if is null throw new ( ) public void DoSomething Foo foo nameof Please let me know if you have another solution. Thanks. Thanks. References: Avoid Check for Null Statement in Java Why I Never Null-Check Parameters Implementing an Exception Helper Class for Parameter Null Checking Code Contracts | MS Docs Code Contracts | MS Reserch Elegant method parameter validation with Code Contracts support Do you throw an argumentexception or argumentnullexception from private methods? Should I throw on null parameters in private/internal methods?
