5.0 updates to System.Text.Json docs

docs/standard/serialization/snippets/system-text-json-how-to-5-0/csharp/CopyOptions.cs

@@ -0,0 +1,37 @@
+
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace CopyOptions
+{
+    public class Forecast
+    {
+        public DateTime Date { get; init; }
+        public int TemperatureC { get; set; }
+        public string Summary { get; set; }
+    };
+
+    public class Program
+    {
+        public static void Main()
+        {
+            Forecast forecast = new()
+            {
+                Date = DateTime.Now,
+                TemperatureC = 40,
+                Summary = "Hot"
+            };
+
+            JsonSerializerOptions options = new();
+            JsonSerializerOptions optionsCopy = new(options)
+            {
+                WriteIndented = true
+            };
+
+            string forecastJson = JsonSerializer.Serialize<Forecast>(forecast, optionsCopy);
+            Console.WriteLine($"Output JSON:\n{forecastJson}");
+        }
+    }
+}

docs/standard/serialization/snippets/system-text-json-how-to-5-0/csharp/CustomConverterHandleNull.cs

@@ -0,0 +1,75 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using System.Diagnostics.CodeAnalysis;
+
+namespace CustomConverterHandleNull
+{
+    public class Point
+    {
+        public int X { get; }
+        public int Y { get; }
+
+        public Dictionary<int, int> AdditionalValues;
+
+        [JsonConverter(typeof(DescriptionConverter))]
+        public string Description { get; set; }
+
+        public Point()
+        {
+        }
+
+        // Specify which ctor should be used when deserializing.
+        // Attribute not needed if this is the only ctor.
+        [JsonConstructor]
+        public Point(int x, int y) => (X, Y) = (x, y);
+    }
+
+    public class DescriptionConverter : JsonConverter<string>
+    {
+        public override bool HandleNull => true;
+
+        public override string Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+        {
+            string val = reader.GetString();
+            return val ?? "No description provided.";
+        }
+
+        public override void Write(Utf8JsonWriter writer, string value, JsonSerializerOptions options)
+        {
+            writer.WriteStringValue(value);
+        }
+    }
+    public class Program
+    {
+        private static JsonSerializerOptions options = new JsonSerializerOptions(JsonSerializerDefaults.Web)
+        {
+            IncludeFields = true,
+            WriteIndented = true
+        };
+
+        public static void Main()
+        {
+            var point = new Point(1, 2)
+            {
+                AdditionalValues = new Dictionary<int, int>
+                {
+                    [3] = 4,
+                    [5] = 6,
+                }
+            };
+
+            string serialized = JsonSerializer.Serialize(point, options);
+            Console.WriteLine($"Output JSON:\n{serialized}");
+
+            point = JsonSerializer.Deserialize<Point>(serialized, options);
+            Console.WriteLine($"X: {point.X}");
+            Console.WriteLine($"Y: {point.Y}");
+            Console.WriteLine($"Additional values count: {point.AdditionalValues.Count}");
+            Console.WriteLine($"AdditionalValues[3]: {point.AdditionalValues[3]}");
+            Console.WriteLine($"AdditionalValues[5]: {point.AdditionalValues[5]}");
+            Console.WriteLine($"Description: {point.Description}");
+        }
+    }
+}

docs/standard/serialization/snippets/system-text-json-how-to-5-0/csharp/Fields.cs

@@ -0,0 +1,41 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Fields
+{
+    public class Forecast
+    {
+        public DateTime Date;
+        public int TemperatureC;
+        public int TemperatureF;
+        public string Summary;
+    }
+    public class Program
+    {
+        public static void Main()
+        {
+            var json = "{\"date\":\"2020-09-06T11:31:01.923395-07:00\",\"temperatureC\":-1,\"temperatureF\":31,\"summary\":\"Scorching\"} ";
+            Console.WriteLine($"Input JSON: {json}");
+
+            var options = new JsonSerializerOptions()
+            {
+                PropertyNameCaseInsensitive = true,
+                IncludeFields = true,
+                PropertyNamingPolicy = JsonNamingPolicy.CamelCase
+            };
+            var forecast = JsonSerializer.Deserialize<Forecast>(json, options);
+
+            Console.WriteLine($"forecast.Date: {forecast.Date}");
+            Console.WriteLine($"forecast.TemperatureC: {forecast.TemperatureC}");
+            Console.WriteLine($"forecast.TemperatureF: {forecast.TemperatureF}");
+            Console.WriteLine($"forecast.Summary: {forecast.Summary}");
+
+            var roundTrippedJson = JsonSerializer.Serialize<Forecast>(forecast, options);
+
+            Console.WriteLine($"Output JSON: {roundTrippedJson}");
+
+        }
+    }
+}

docs/standard/serialization/snippets/system-text-json-how-to-5-0/csharp/GuidReferenceResolverExample.cs

@@ -0,0 +1,78 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Diagnostics;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace GuidReferenceResolverExample
+{
+    public class Person
+    {
+        internal Guid Id { get; set; }
+        public string Name { get; set; }
+        public Person Spouse { get; set; }
+    }
+
+    public class GuidReferenceResolver : ReferenceResolver
+    {
+        private readonly IDictionary<Guid, Person> _people = new Dictionary<Guid, Person>();
+
+        public override object ResolveReference(string referenceId)
+        {
+            Guid id = new Guid(referenceId);
+
+            Person p;
+            _people.TryGetValue(id, out p);
+
+            return p;
+        }
+
+        public override string GetReference(object value, out bool alreadyExists)
+        {
+            Person p = (Person)value;
+
+            alreadyExists = _people.ContainsKey(p.Id);
+            _people[p.Id] = p;
+
+            return p.Id.ToString();
+        }
+
+        public override void AddReference(string reference, object value)
+        {
+            Guid id = new Guid(reference);
+            Person person = (Person)value;
+            person.Id = id;
+            _people[id] = person;
+        }
+    }
+
+    static class Program
+    {
+        public static void Main()
+        {
+            Person tyler = new() { Id = Guid.NewGuid(), Name = "Tyler" };
+            Person adrian = new() { Id = Guid.NewGuid(), Name = "Adrian" };
+            tyler.Spouse = adrian;
+            adrian.Spouse = tyler;
+            var people = ImmutableArray.Create(tyler, adrian);
+
+            var options = new JsonSerializerOptions
+            {
+                WriteIndented = true,
+                ReferenceHandler = new ReferenceHandler<GuidReferenceResolver>()
+            };
+
+            string json = JsonSerializer.Serialize(people, options);
+            Console.WriteLine($"Output JSON {json}");
+
+            List<Person> peopleDeserialized = JsonSerializer.Deserialize<List<Person>>(json, options);
+
+            Person tylerDeserialized = people[0];
+            Person adrianDeserialized = people[1];
+
+            Console.WriteLine($"Adrian is Tyler's spouse: {tylerDeserialized.Equals(adrianDeserialized.Spouse)}");
+            Console.WriteLine($"Tyler is Adrian's spouse: {adrianDeserialized.Equals(tylerDeserialized.Spouse)}");
+        }
+    }
+}

docs/standard/serialization/snippets/system-text-json-how-to-5-0/csharp/HttpClientExtensionMethods.cs

@@ -0,0 +1,37 @@
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Net.Http.Json;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+
+namespace HttpClientExtensionMethods
+{
+    public class User
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string Username { get; set; }
+        public string Email { get; set; }
+    }
+    public class Program
+    {
+        public static async Task Main()
+        {
+            var client = new HttpClient();
+            client.BaseAddress = new Uri("https://jsonplaceholder.typicode.com");
+
+            // Get the user information.
+            User user = await client.GetFromJsonAsync<User>("users/1");
+            Console.WriteLine($"Id: {user.Id}");
+            Console.WriteLine($"Name: {user.Name}");
+            Console.WriteLine($"Username: {user.Username}");
+            Console.WriteLine($"Email: {user.Email}");
+
+            // Post a new user.
+            HttpResponseMessage response = await client.PostAsJsonAsync("users", user);
+            Console.WriteLine((response.IsSuccessStatusCode ? "Success" : "Error") + $" - {response.StatusCode}");
+        }
+    }
+}

docs/standard/serialization/snippets/system-text-json-how-to-5-0/csharp/IgnoreValueDefaultOnSerialize.cs

@@ -0,0 +1,37 @@
+#nullable enable
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace IgnoreValueDefaultOnSerialize
+{
+    public class Forecast
+    {
+        public DateTime Date { get; set; }
+        public int TemperatureC { get; set; }
+        public string? Summary { get; set; }
+    };
+
+    public class Program
+    {
+        public static void Main()
+        {
+
+            Forecast forecast = new()
+            {
+                Date = DateTime.Now,
+                Summary = null,
+                TemperatureC = default(int)
+            };
+
+            JsonSerializerOptions options = new()
+            {
+                DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingDefault
+            };
+
+            string forecastJson = JsonSerializer.Serialize<Forecast>(forecast, options);
+            Console.WriteLine(forecastJson);
+        }
+    }
+}

docs/standard/serialization/snippets/system-text-json-how-to-5-0/csharp/ImmutableTypes.cs

@@ -0,0 +1,49 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace ImmutableTypes
+{
+    public struct Forecast
+    {
+        public DateTime Date { get; }
+        public int TemperatureC { get; }
+        public int TemperatureF { get; }
+        public string Summary { get; }
+        [JsonConstructor]
+        public Forecast(
+            DateTime date,
+            int temperatureC,
+            int temperatureF,
+            string summary) =>
+                (Date, TemperatureC, TemperatureF, Summary) =
+                    (date, temperatureC, temperatureF, summary);
+    }
+    public class Program
+    {
+        public static void Main()
+        {
+            var json = "{\"date\":\"2020-09-06T11:31:01.923395-07:00\",\"temperatureC\":-1,\"temperatureF\":31,\"summary\":\"Scorching\"} ";
+            Console.WriteLine($"Input JSON: {json}");
+
+            var options = new JsonSerializerOptions()
+            {
+                PropertyNameCaseInsensitive = true,
+                //IncludeFields = true,
+                PropertyNamingPolicy = JsonNamingPolicy.CamelCase
+            };
+            var forecast = JsonSerializer.Deserialize<Forecast>(json, options);
+
+            Console.WriteLine($"forecast.Date: {forecast.Date}");
+            Console.WriteLine($"forecast.TemperatureC: {forecast.TemperatureC}");
+            Console.WriteLine($"forecast.TemperatureF: {forecast.TemperatureF}");
+            Console.WriteLine($"forecast.Summary: {forecast.Summary}");
+
+            var roundTrippedJson = JsonSerializer.Serialize<Forecast>(forecast, options);
+
+            Console.WriteLine($"Output JSON: {roundTrippedJson}");
+
+        }
+    }
+}