JSON serialization – DataContractJsonSerializer vs JavaScriptSerializer

You can become a serverless blackbelt. Enrol to my 4-week online workshop Production-Ready Serverless and gain hands-on experience building something from scratch using serverless technologies. At the end of the workshop, you should have a broader view of the challenges you will face as your serverless architecture matures and expands. You should also have a firm grasp on when serverless is a good fit for your system as well as common pitfalls you need to avoid. Sign up now and get 15% discount with the code yanprs15!

In C#, when you have to work with JSON data you’re usually represented with two choices – DataContractJsonSerializer or JavaScriptSerializer. There are other popular third-party libraries out there, such as the popular Json.Net project, but for the rest of this blog let’s just focus on the two built-in JSON serializers and see how they differ.

DataContracts

Without doubt the biggest difference between the two is that DataContractJsonSerializer only works with types decorated with the DataContract attribute, but JavaScriptSerializer can work with any object.

This makes perfect sense as the primary purpose of the DataContractJsonSerializer is to be used with WCF, and just as its name suggests, it’s a JSON serializer for DataContract types.

Anonymous Types

One interesting side effect of the above is that you can’t use DataContractJsonSerializer with anonymous types.

On the other hand, with the JavaScriptSerializer at least you can easily serialize an instance of an anonymous type:

   1: var jsSerializer = new JavaScriptSerializer();

   2:

   3: // define an anonymous type

   4: var anonymous = new { Id = Guid.NewGuid(), Name = "Yan", Age = 29 };

   5:

   6: // this writes:

   7: // {"Id":"2edebefb-2585-438c-bbc3-939e7688f630","Name":"Yan","Age":29}

   8: Console.WriteLine(jsSerializer.Serialize(anonymous));

Unfortunately you won’t be able to deserialize the JSON string back into an anonymous type as all the available deserialize methods requires a type which has a parameterless constructor.

Dictionaries

Another main functional difference between these two serializers is how they deal with dictionaries.

Take this simple dictionary for instance:

   1: var dictionary = new Dictionary<string, object>();

   2: dictionary.Add("Id", Guid.NewGuid());

   3: dictionary.Add("Name", "Yan");

   4: dictionary.Add("Age", 29);

The DataContractJsonSerializer serializes dictionaries as an array of KeyValuePair objects:

[{“Key”:”Id”,”Value”:”35285943-32d0-45d9-ada6-eb570f757d85″},{“Key”:”Name”,”Value”:”Yan”},{“Key”:”Age”,”Value”:29}]

whereas the JavaScriptSerializer serializes dictionaries in a much more ‘JSON’ way:

{“Id”:”35285943-32d0-45d9-ada6-eb570f757d85″,”Name”:”Yan”,”Age”:29}

This subtle different might seem trivial at first, but it can make a huge difference when you’re dealing with data that are originated from a non-.Net language. A perfect example came couple of days ago when we were testing out the Facebook graph API and one of the JSON responses we came across was a dictionary whose keys were numeric IDs like this:

{“1652438520054”:{“id”:”1652438520054″, …}}

In cases like this, you simply won’t be able to deserialize this JSON using the DataContractJsonSerializer!

Liked this article? Support me on Patreon and get direct help from me via a private Slack channel or 1-2-1 mentoring.
Subscribe to my weekly newsletter


Hi, I’m Yan. I’m an AWS Serverless Hero and I help companies go faster for less by adopting serverless technologies successfully.

Are you struggling with serverless or need guidance on best practices? Do you want someone to review your architecture and help you avoid costly mistakes down the line? Whatever the case, I’m here to help.

Hire me.


Skill up your serverless game with this hands-on workshop.

My 4-week Production-Ready Serverless online workshop is back!

This course takes you through building a production-ready serverless web application from testing, deployment, security, all the way through to observability. The motivation for this course is to give you hands-on experience building something with serverless technologies while giving you a broader view of the challenges you will face as the architecture matures and expands.

We will start at the basics and give you a firm introduction to Lambda and all the relevant concepts and service features (including the latest announcements in 2020). And then gradually ramping up and cover a wide array of topics such as API security, testing strategies, CI/CD, secret management, and operational best practices for monitoring and troubleshooting.

If you enrol now you can also get 15% OFF with the promo code “yanprs15”.

Enrol now and SAVE 15%.


Check out my new podcast Real-World Serverless where I talk with engineers who are building amazing things with serverless technologies and discuss the real-world use cases and challenges they face. If you’re interested in what people are actually doing with serverless and what it’s really like to be working with serverless day-to-day, then this is the podcast for you.


Check out my new course, Learn you some Lambda best practice for great good! In this course, you will learn best practices for working with AWS Lambda in terms of performance, cost, security, scalability, resilience and observability. We will also cover latest features from re:Invent 2019 such as Provisioned Concurrency and Lambda Destinations. Enrol now and start learning!


Check out my video course, Complete Guide to AWS Step Functions. In this course, we’ll cover everything you need to know to use AWS Step Functions service effectively. There is something for everyone from beginners to more advanced users looking for design patterns and best practices. Enrol now and start learning!