You can use the JsonPropertyOrder attribute to control the order that properties get serialized. You specify the order as an integer, and it serializes the properties in ascending order. Here’s an example:
using System.Text.Json.Serialization;
public class Programmer
{
[JsonPropertyOrder(2)]
public string LastName { get; set; }
[JsonPropertyOrder(1)]
public string FirstName { get; set; }
[JsonPropertyOrder(-1)]
public string Language { get; set; }
}
Code language: C# (cs)
Note: Properties have a default order value of 0.
Now serialize an object to JSON:
using System.Text.Json;
var json = JsonSerializer.Serialize(new Programmer()
{
FirstName = "Jason",
LastName = "Bourne",
Language = "C#",
}, new JsonSerializerOptions() { WriteIndented = true });
Console.WriteLine(json);
Code language: C# (cs)
This generates the following JSON:
{
"Language": "C#",
"FirstName": "Jason",
"LastName": "Bourne"
}
Code language: JSON / JSON with Comments (json)
Notice the properties are serialized in ascending order based on the JsonPropertyOrder value:
- Language (-1)
- FirstName (1)
- LastName (2)
The JsonPropertyOrder attribute was added in System.Text.Json v6.0.0. Note: This package targets .NET Standard 2.0 – so you can use this feature even if you’re not on .NET 6.
Table of Contents
Default property serialization order
When you use System.Text.Json to serialize an object, it uses reflection to get the declared (non-inherited) properties first. Then if you’re using inheritance, it will go through the inheritance hierarchy and get the inherited properties. Within each group of properties, there’s no guaranteed default order of serialization.
Why is there no guaranteed default order?
You may think it’d serialize the properties based on the order they’re declared in the class, but that’s not the case. It uses Type.GetProperties() to get the properties and this method doesn’t guarantee ordering:
The GetProperties method does not return properties in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which properties are returned, because that order varies.
Ref: Microsoft – System.Type.GetProperties
This explains why you have to use the JsonPropertyOrder attribute if you want to change the serialization order.
Read more about how to serialize to JSON in alphabetical order.
Declared properties first, then inherited properties
Serialization is done on two groups in order:
- Declare properties (non-inherited) are serialized first.
- Inherited properties are serialized second.
Within these two groups, there’s no guarenteed ordering.
Let’s say you have the following two classes. The Driver class subclasses the Person base class, inheriting all of its properties:
public abstract class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int Id { get; set; }
}
public class Driver : Person
{
public string Car { get; set; }
}
Code language: C# (cs)
Now serialize a Driver object:
using System.Text.Json;
var json = JsonSerializer.Serialize(new Driver()
{
FirstName = "John",
LastName = "Wick",
Car = "Ford Mustang",
Id = 123
}, new JsonSerializerOptions() { WriteIndented = true });
Console.WriteLine(json);
Code language: C# (cs)
Here’s the JSON this produces. Notice the Driver.Car property is first, followed by all of inherited properties from the Person base class:
{
"Car": "Ford Mustang",
"FirstName": "John",
"LastName": "Wick",
"Id": 123
}
Code language: JSON / JSON with Comments (json)
Example – Serialize a base class property first
By default, base class properties are serialized last. One common scenario is wanting to serialize one or more base class properties first. Here’s an example of applying the JsonPropertyOrder attribute to a base class property to make sure it gets serialized first:
using System.Text.Json.Serialization;
public abstract class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
[JsonPropertyOrder(-1000)]
public int Id { get; set; }
}
public class Driver : Person
{
public string Car { get; set; }
}
Code language: C# (cs)
Serialize a Driver object:
using System.Text.Json;
var json = JsonSerializer.Serialize(new Driver()
{
FirstName = "James",
LastName = "Bond",
Car = "Aston Martin",
Id = 456
}, new JsonSerializerOptions() { WriteIndented = true });
Console.WriteLine(json);
Code language: C# (cs)
Notice that it put the Id property from the Person base class first:
{
"Id": 456,
"Car": "Aston Martin",
"FirstName": "James",
"LastName": "Bond"
}
Code language: JSON / JSON with Comments (json)
Thanks man! It worked well here!
Why the article does not say the most important thing, how to make it serialize any objects and fields only in alphabetical order?
That’s a very specific requirement, so I wrote an article about it to explain it: C# – Serialize to JSON in alphabetical order
To briefly explain this:
1. Manually alphabetize and use JsonPropertyOrder.
2. Write a custom contract resolver that changes the properties to alphabetical order automatically (available in System.Text.Json v7)
3. Otherwise, as a fallback option: Write a custom JSON converter that uses reflection to get the list of properties, then sort the list in alphabetical order, then writes them to JSON. This is more complex, but if you want to do this for a whole bunch of classes, this is the best option.