title: How to parse huge JSON file as stream in Json.NET?
body: <p>I have a very, very large JSON file (1000+ MB) of identical JSON objects. For example:</p>
  
  <pre><code>[
      {
          "id": 1,
          "value": "hello",
          "another_value": "world",
          "value_obj": {
              "name": "obj1"
          },
          "value_list": [
              1,
              2,
              3
          ]
      },
      {
          "id": 2,
          "value": "foo",
          "another_value": "bar",
          "value_obj": {
              "name": "obj2"
          },
          "value_list": [
              4,
              5,
              6
          ]
      },
      {
          "id": 3,
          "value": "a",
          "another_value": "b",
          "value_obj": {
              "name": "obj3"
          },
          "value_list": [
              7,
              8,
              9
          ]
  
      },
      ...
  ]
  </code></pre>
  
  <p>Every single item in the root JSON list follows the same structure and thus would be individually deserializable. I already have the C# classes written to receive this data, and deserializing a JSON file containing a single object without the list works as expected.</p>
  
  <p>At first, I tried to just directly deserialize my objects in a loop:</p>
  
  <pre><code>JsonSerializer serializer = new JsonSerializer();
  MyObject o;
  using (FileStream s = File.Open("bigfile.json", FileMode.Open))
  using (StreamReader sr = new StreamReader(s))
  using (JsonReader reader = new JsonTextReader(sr))
  {
      while (!sr.EndOfStream)
      {
          o = serializer.Deserialize&lt;MyObject&gt;(reader);
      }
  }
  </code></pre>
  
  <p>This didn't work, threw an exception clearly stating that an object is expected, not a list. My understanding is that this command would just read a single object contained at the root level of the JSON file, but since we have a <em>list</em> of objects, this is an invalid request.</p>
  
  <p>My next idea was to deserialize as a C# List of objects:</p>
  
  <pre><code>JsonSerializer serializer = new JsonSerializer();
  List&lt;MyObject&gt; o;
  using (FileStream s = File.Open("bigfile.json", FileMode.Open))
  using (StreamReader sr = new StreamReader(s))
  using (JsonReader reader = new JsonTextReader(sr))
  {
      while (!sr.EndOfStream)
      {
          o = serializer.Deserialize&lt;List&lt;MyObject&gt;&gt;(reader);
      }
  }
  </code></pre>
  
  <p>This does succeed. However, it only somewhat reduces the issue of high RAM usage. In this case it does look like the application is deserializing items one at a time, and so is not reading the entire JSON file into RAM, but we still end up with a lot of RAM usage because the C# List object now contains all of the data from the JSON file in RAM. This has only displaced the problem.</p>
  
  <p>I then decided to simply try taking a single character off the beginning of the stream (to eliminate the <code>[</code>) by doing <code>sr.Read()</code> before going into the loop. The first object then does read successfully, but subsequent ones do not, with an exception of "unexpected token". My guess is this is the comma and space between the objects throwing the reader off.</p>
  
  <p>Simply removing square brackets won't work since the objects do contain a primitive list of their own, as you can see in the sample. Even trying to use <code>},</code> as a separator won't work since, as you can see, there are sub-objects within the objects.</p>
  
  <p>What my goal is, is to be able to read the objects from the stream one at a time. Read an object, do something with it, then discard it from RAM, and read the next object, and so on. This would eliminate the need to load either the entire JSON string or the entire contents of the data into RAM as C# objects. </p>
  
  <p>What am I missing?</p>