C# - Anonymous Type

Updated on:

In C#, an anonymous type is a type (class) without any name that can contain public read-only properties only. It cannot contain other members, such as fields, methods, events, etc.

You create an anonymous type using the new operator with an object initializer syntax. The implicitly typed variable- var is used to hold the reference of anonymous types.

The following example demonstrates creating an anonymous type student with three properties named Id, FirstName, and LastName.

Example: Anonymous Type
var student = new { Id = 1, FirstName = "James", LastName = "Bond" };

The properties of anonymous types are read-only and cannot be initialized with a null, anonymous function, or a pointer type. The properties can be accessed using dot (.) notation, same as object properties. However, you cannot change the values of properties as they are read-only.

Example: Access Anonymous Type
var student = new { Id = 1, FirstName = "James", LastName = "Bond" };
Console.WriteLine(student.Id); //output: 1
Console.WriteLine(student.FirstName); //output: James
Console.WriteLine(student.LastName); //output: Bond

//the following will give compile-time error
student.Id = 2;//error
student.FirstName = "Steve";//error

An anonymous type's property can include another anonymous type.

Example: Nested Anonymous Type
var student = new { 
                    Id = 1, 
                    FirstName = "James", 
                    LastName = "Bond",
                    Address = new { Id = 1, City = "London", Country = "UK" }

You can create an array of anonymous types also.

Example: Array of Anonymous Types
var students = new[] {
            new { Id = 1, FirstName = "James", LastName = "Bond" },
            new { Id = 2, FirstName = "Steve", LastName = "Jobs" },
            new { Id = 3, FirstName = "Bill", LastName = "Gates" }

An anonymous type will always be local to the method where it is defined. It cannot be returned from the method. However, an anonymous type can be passed to the method as object type parameter, but it is not recommended. If you need to pass it to another method, then use struct or class instead of an anonymous type.

Mostly, anonymous types are created using the Select clause of a LINQ queries to return a subset of the properties from each object in the collection.

Example: LINQ Query returns an Anonymous Type
class Program
    static void Main(string[] args)
        IList<Student> studentList = new List<Student>() { 
            new Student() { StudentID = 1, StudentName = "John", age = 18 },
            new Student() { StudentID = 2, StudentName = "Steve",  age = 21 },
            new Student() { StudentID = 3, StudentName = "Bill",  age = 18 },
            new Student() { StudentID = 4, StudentName = "Ram" , age = 20  },
            new Student() { StudentID = 5, StudentName = "Ron" , age = 21 } 

        var students = from s in studentList
                       select new { Id = s.StudentID, Name = s.StudentName };

        foreach(var stud in students)
            Console.WriteLine(stud.Id + "-" + stud.Name);

public class Student
    public int StudentID { get; set; }
    public string StudentName { get; set; }
    public int age { get; set; }

In the above example, a select clause in the LINQ query selects only StudentID and StudentName properties and renames it to Id and Name, respectively. Thus, it is useful in saving memory and unnecessary code. The query result collection includes only StudentID and StudentName properties, as shown in the following debug view.

Visual Studio supports IntelliSense for anonymous types, as shown below.

Anonymous Type in debug view
Anonymous Type Intellisense Support in Visual Studio

Internally, all the anonymous types are directly derived from the Object class. The compiler generates a class with some auto-generated name and applies the appropriate type to each property based on the value expression. Although your code cannot access it. Use GetType() method to see the name.

Example: LINQ Query returns an Anonymous Type
static void Main(string[] args)
    var student = new { Id = 1, FirstName = "James", LastName = "Bond" };
Points to Remember:
  1. Anonymous type is created using the new keyword and object initializer syntax.
  2. The implicitly typed variable - var, is used to hold the reference of an anonymous type.
  3. Anonymous type is a reference type data type and all the properties are read-only. It cannot contain methods, events, indexer or any other members.
  4. A field, property, event, indexer, or return type of a method cannot be anonymous types.
  5. The scope of an anonymous type is local to the method where it is defined. Mostly used in LINQ queries for temperory use.