default Keyword
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

default Keyword in Generic Code (C# Programming Guide)

Updated: September 2008

In generic classes and methods, one issue that arises is how to assign a default value to a parameterized type T when you do not know the following in advance:

  • Whether T will be a reference type or a value type.

  • If T is a value type, whether it will be a numeric value or a struct.

Given a variable t of a parameterized type T, the statement t = null is only valid if T is a reference type and t = 0 will only work for numeric value types but not for structs. The solution is to use the default keyword, which will return null for reference types and zero for numeric value types. For structs, it will return each member of the struct initialized to zero or null depending on whether they are value or reference types. For nullable value types, default returns a System.Nullable<T>, which is initialized like any struct.

The following example from the GenericList<T> class shows how to use the default keyword. For more information, see Generics Overview.

namespace ConsoleApplication1
    class Program
        static void Main(string[] args)
            // Test with a non-empty list of integers.
            GenericList<int> gll = new GenericList<int>();
            int intVal = gll.GetLast();
            // The following line displays 5.

            // Test with an empty list of integers.
            GenericList<int> gll2 = new GenericList<int>();
            intVal = gll2.GetLast();
            // The following line displays 0.

            // Test with a non-empty list of strings.
            GenericList<string> gll3 = new GenericList<string>();
            string sVal = gll3.GetLast();
            // The following line displays five.

            // Test with an empty list of strings.
            GenericList<string> gll4 = new GenericList<string>();
            sVal = gll4.GetLast();
            // The following line displays a blank line.

    // T is the type of data stored in a particular instance of GenericList. 
    public class GenericList<T>
        private class Node
            // Each node has a reference to the next node in the list. 
            public Node Next;
            // Each node holds a value of type T. 
            public T Data;

        // The list is initially empty. 
        private Node head = null;

        // Add a node at the beginning of the list with t as its data value. 
        public void AddNode(T t)
            Node newNode = new Node();
            newNode.Next = head;
            newNode.Data = t;
            head = newNode;

        // The following method returns the data value stored in the last node in 
        // the list. If the list is empty, the default value for type T is 
        // returned. 
        public T GetLast()
            // The value of temp is returned as the value of the method.  
            // The following declaration initializes temp to the appropriate  
            // default value for type T. The default value is returned if the  
            // list is empty.
            T temp = default(T);

            Node current = head;
            while (current != null)
                temp = current.Data;
                current = current.Next;
            return temp;




September 2008

Clarified and updated text regarding nullable types.

Customer feedback.

© 2016 Microsoft