HomeSearch

C# DefaultIfEmpty Method

Use the DefaultIfEmpty extension method from System.Linq to get a default value if no elements are present.

DefaultIfEmpty

handles empty collections in a special way. It returns a default value, not an error. With it, we replace empty collections with a singleton collection that may be more compatible with other parts of the C# program.

Example.

The concept of DefaultIfEmpty is simple: it replaces an empty collection with a collection of one default value. Remember that the default value of int is 0. Thus, DefaultIfEmpty on a List<int> yields a List with one zero element.

Argument: You can pass an argument to DefaultIfEmpty. This will become the value that is used in the singleton collection's value.

C# program that uses DefaultIfEmpty using System; using System.Collections.Generic; using System.Linq; class Program { static void Main() { // Empty list. List<int> list = new List<int>(); var result = list.DefaultIfEmpty(); // One element in collection with default(int) value. foreach (var value in result) { Console.WriteLine(value); } result = list.DefaultIfEmpty(-1); // One element in collection with -1 value. foreach (var value in result) { Console.WriteLine(value); } } } Output 0 -1

Usage.

If you call DefaultIfEmpty on a null reference, you will get a NullReferenceException. DefaultIfEmpty can only be used to handle empty collections. It is useful if in other locations in your program, empty collections cannot be used.NullNullReferenceException

The version

that receives an argument may be more useful. You can use a custom default object that has special behavior. In the book Refactoring, this technique is referred to as a null object (see Introduce Null Object).

Tip: You could pass a reference to the null object to DefaultIfEmpty. Then methods can act without knowing about empty collections.

Summary.

We saw the behavior of the DefaultIfEmpty method on an empty List collection. The method changes empty collections to collections with one element. With the optional parameter, you can use custom default objects.
Home
Dot Net Perls
© 2007-2019 Sam Allen. All rights reserved. Written by Sam Allen, info@dotnetperls.com.