<PackageReference Include="System.Text.Json" Version="5.0.0-preview.2.20160.6" />

---

API Differences between 5.0.0-preview.2.20160.6 and 4.6.0-preview6.19259.10

315 Additions 22 Removals

System.Text.Json

• public enum DuplicatePropertyNameHandlingStrategy
  • Error = 2
  • Ignore = 1
  • Replace = 0
• public sealed class JsonArray : JsonNode, IList<JsonNode>, ICollection<JsonNode>, IEnumerable<JsonNode>, IEnumerable, IReadOnlyList<JsonNode>, IReadOnlyCollection<JsonNode>
  • public int Count { get; }
  • public bool IsReadOnly { get; }
  • public JsonNode this[int idx] { get; set; }
  • public JsonArray()
  • public JsonArray(IEnumerable<JsonNode> values)
  • public JsonArray(IEnumerable<string> values)
  • public JsonArray(IEnumerable<bool> values)
  • public JsonArray(IEnumerable<byte> values)
  • public JsonArray(IEnumerable<short> values)
  • public JsonArray(IEnumerable<int> values)
  • public JsonArray(IEnumerable<long> values)
  • public JsonArray(IEnumerable<float> values)
  • public JsonArray(IEnumerable<double> values)
  • public JsonArray(IEnumerable<sbyte> values)
  • public JsonArray(IEnumerable<ushort> values)
  • public JsonArray(IEnumerable<uint> values)
  • public JsonArray(IEnumerable<ulong> values)
  • public JsonArray(IEnumerable<decimal> values)
  • public void Add(JsonNode value)
  • public void Clear()
  • public bool Contains(JsonNode value)
  • public JsonArrayEnumerator GetEnumerator()
  • public int IndexOf(JsonNode item)
  • public void Insert(int index, JsonNode item)
  • public int LastIndexOf(JsonNode item)
  • public bool Remove(JsonNode item)
  • public int RemoveAll(Predicate<JsonNode> match)
  • public void RemoveAt(int index)
• public struct JsonArrayEnumerator : IEnumerator<JsonNode>, IEnumerator, IDisposable
  • public JsonNode Current { get; }
  • public JsonArrayEnumerator(JsonArray jsonArray)
  • public void Dispose()
  • public bool MoveNext()
• public sealed class JsonBoolean : JsonNode, IEquatable<JsonBoolean>
  • public bool Value { get; set; }
  • public JsonBoolean()
  • public JsonBoolean(bool value)
  • public static bool op_Equality(JsonBoolean left, JsonBoolean right)
  • public static bool op_Inequality(JsonBoolean left, JsonBoolean right)
  • public bool Equals(JsonBoolean other)
• public sealed class JsonDocument : IDisposable
  • public static JsonDocument Parse(ReadOnlyMemory<byte> utf8Json, JsonReaderOptions readerOptions = default)
  • public static JsonDocument Parse(ReadOnlySequence<byte> utf8Json, JsonReaderOptions readerOptions = default)
  • public static JsonDocument Parse(Stream utf8Json, JsonReaderOptions readerOptions = default)
  • public static JsonDocument Parse(ReadOnlyMemory<char> json, JsonReaderOptions readerOptions = default)
  • public static JsonDocument Parse(string json, JsonReaderOptions readerOptions = default)
  • public static Task<JsonDocument> ParseAsync(Stream utf8Json, JsonReaderOptions readerOptions = default, CancellationToken cancellationToken = default)
  • public static JsonDocument Parse(ReadOnlyMemory<byte> utf8Json, JsonDocumentOptions options = default)
  • public static JsonDocument Parse(ReadOnlySequence<byte> utf8Json, JsonDocumentOptions options = default)
  • public static JsonDocument Parse(Stream utf8Json, JsonDocumentOptions options = default)
  • public static JsonDocument Parse(ReadOnlyMemory<char> json, JsonDocumentOptions options = default)
  • public static JsonDocument Parse(string json, JsonDocumentOptions options = default)
  • public static Task<JsonDocument> ParseAsync(Stream utf8Json, JsonDocumentOptions options = default, CancellationToken cancellationToken = default)
  • public void WriteTo(Utf8JsonWriter writer)
• public struct JsonDocumentOptions
  • public bool AllowTrailingCommas { get; set; }
  • public JsonCommentHandling CommentHandling { get; set; }
  • public int MaxDepth { get; set; }
• public struct JsonElement
  • public bool IsImmutable { get; }
  • public JsonValueType Type { get; }
  • public JsonValueKind ValueKind { get; }
  • public byte GetByte()
  • public byte[] GetBytesFromBase64()
  • public short GetInt16()
  • public sbyte GetSByte()
  • public ushort GetUInt16()
  • public bool TryGetByte(out byte value)
  • public bool TryGetBytesFromBase64(out byte value)
  • public bool TryGetInt16(out short value)
  • public bool TryGetSByte(out sbyte value)
  • public bool TryGetUInt16(out ushort value)
  • public void WriteAsProperty(ReadOnlySpan<char> propertyName, Utf8JsonWriter writer)
  • public void WriteAsProperty(ReadOnlySpan<byte> utf8PropertyName, Utf8JsonWriter writer)
  • public void WriteAsValue(Utf8JsonWriter writer)
  • public bool ValueEquals(string text)
  • public bool ValueEquals(ReadOnlySpan<byte> utf8Text)
  • public bool ValueEquals(ReadOnlySpan<char> text)
  • public void WriteTo(Utf8JsonWriter writer)
• public struct JsonEncodedText : IEquatable<JsonEncodedText>
  • public static JsonEncodedText Encode(string value)
  • public static JsonEncodedText Encode(ReadOnlySpan<char> value)
  • public static JsonEncodedText Encode(ReadOnlySpan<byte> utf8Value)
  • public static JsonEncodedText Encode(string value, JavaScriptEncoder encoder = null)
  • public static JsonEncodedText Encode(ReadOnlySpan<char> value, JavaScriptEncoder encoder = null)
  • public static JsonEncodedText Encode(ReadOnlySpan<byte> utf8Value, JavaScriptEncoder encoder = null)
• public class JsonException : Exception
  • public JsonException(string message, Exception innerException)
  • public JsonException(string message)
  • public JsonException()
• public abstract class JsonNamingPolicy
  • public static JsonNamingPolicy CamelCase { get; }
  • protected JsonNamingPolicy()
  • public abstract string ConvertName(string name)
• public abstract class JsonNode
  • public abstract JsonValueKind ValueKind { get; }
  • public static JsonNode DeepCopy(JsonElement jsonElement)
  • public static JsonNode GetNode(JsonElement jsonElement)
  • public static JsonNode op_Implicit(string value)
  • public static JsonNode op_Implicit(DateTime value)
  • public static JsonNode op_Implicit(DateTimeOffset value)
  • public static JsonNode op_Implicit(Guid value)
  • public static JsonNode op_Implicit(bool value)
  • public static JsonNode op_Implicit(byte value)
  • public static JsonNode op_Implicit(short value)
  • public static JsonNode op_Implicit(int value)
  • public static JsonNode op_Implicit(long value)
  • public static JsonNode op_Implicit(float value)
  • public static JsonNode op_Implicit(double value)
  • public static JsonNode op_Implicit(sbyte value)
  • public static JsonNode op_Implicit(ushort value)
  • public static JsonNode op_Implicit(uint value)
  • public static JsonNode op_Implicit(ulong value)
  • public static JsonNode op_Implicit(decimal value)
  • public static JsonNode Parse(string json, JsonNodeOptions options = default)
  • public static bool TryGetNode(JsonElement jsonElement, out JsonNode jsonNode)
  • public JsonElement AsJsonElement()
  • public abstract JsonNode Clone()
  • public string ToJsonString()
  • public void WriteTo(Utf8JsonWriter writer)
• public struct JsonNodeOptions
  • public bool AllowTrailingCommas { get; set; }
  • public JsonCommentHandling CommentHandling { get; set; }
  • public DuplicatePropertyNameHandlingStrategy DuplicatePropertyNameHandling { get; set; }
  • public int MaxDepth { get; set; }
• public sealed class JsonNull : JsonNode, IEquatable<JsonNull>
  • public JsonNull()
  • public static bool op_Equality(JsonNull left, JsonNull right)
  • public static bool op_Inequality(JsonNull left, JsonNull right)
  • public bool Equals(JsonNull other)
• public sealed class JsonNumber : JsonNode, IEquatable<JsonNumber>
  • public JsonNumber()
  • public JsonNumber(string value)
  • public JsonNumber(byte value)
  • public JsonNumber(short value)
  • public JsonNumber(int value)
  • public JsonNumber(long value)
  • public JsonNumber(float value)
  • public JsonNumber(double value)
  • public JsonNumber(sbyte value)
  • public JsonNumber(ushort value)
  • public JsonNumber(uint value)
  • public JsonNumber(ulong value)
  • public JsonNumber(decimal value)
  • public static bool op_Equality(JsonNumber left, JsonNumber right)
  • public static bool op_Inequality(JsonNumber left, JsonNumber right)
  • public bool Equals(JsonNumber other)
  • public byte GetByte()
  • public decimal GetDecimal()
  • public double GetDouble()
  • public short GetInt16()
  • public int GetInt32()
  • public long GetInt64()
  • public sbyte GetSByte()
  • public float GetSingle()
  • public ushort GetUInt16()
  • public uint GetUInt32()
  • public ulong GetUInt64()
  • public void SetByte(byte value)
  • public void SetDecimal(decimal value)
  • public void SetDouble(double value)
  • public void SetFormattedValue(string value)
  • public void SetInt16(short value)
  • public void SetInt32(int value)
  • public void SetInt64(long value)
  • public void SetSByte(sbyte value)
  • public void SetSingle(float value)
  • public void SetUInt16(ushort value)
  • public void SetUInt32(uint value)
  • public void SetUInt64(ulong value)
  • public bool TryGetByte(out byte value)
  • public bool TryGetDecimal(out decimal value)
  • public bool TryGetDouble(out double value)
  • public bool TryGetInt16(out short value)
  • public bool TryGetInt32(out int value)
  • public bool TryGetInt64(out long value)
  • public bool TryGetSByte(out sbyte value)
  • public bool TryGetSingle(out float value)
  • public bool TryGetUInt16(out ushort value)
  • public bool TryGetUInt32(out uint value)
  • public bool TryGetUInt64(out ulong value)
• public sealed class JsonObject : JsonNode, IEnumerable<KeyValuePair<string, JsonNode>>, IEnumerable
  • public JsonNode this[string propertyName] { get; set; }
  • public JsonObject()
  • public JsonObject(IEnumerable<KeyValuePair<string, JsonNode>> jsonProperties)
  • public void Add(KeyValuePair<string, JsonNode> jsonProperty)
  • public void Add(string propertyName, JsonNode propertyValue)
  • public void AddRange(IEnumerable<KeyValuePair<string, JsonNode>> jsonProperties)
  • public bool ContainsProperty(string propertyName)
  • public bool ContainsProperty(string propertyName, StringComparison stringComparison)
  • public JsonObjectEnumerator GetEnumerator()
  • public JsonArray GetJsonArrayPropertyValue(string propertyName)
  • public JsonArray GetJsonArrayPropertyValue(string propertyName, StringComparison stringComparison)
  • public JsonObject GetJsonObjectPropertyValue(string propertyName)
  • public JsonObject GetJsonObjectPropertyValue(string propertyName, StringComparison stringComparison)
  • public IReadOnlyCollection<string> GetPropertyNames()
  • public JsonNode GetPropertyValue(string propertyName)
  • public JsonNode GetPropertyValue(string propertyName, StringComparison stringComparison)
  • public IReadOnlyCollection<JsonNode> GetPropertyValues()
  • public bool Remove(string propertyName)
  • public bool Remove(string propertyName, StringComparison stringComparison)
  • public bool TryGetJsonArrayPropertyValue(string propertyName, out JsonArray jsonArray)
  • public bool TryGetJsonArrayPropertyValue(string propertyName, StringComparison stringComparison, out JsonArray jsonArray)
  • public bool TryGetJsonObjectPropertyValue(string propertyName, out JsonObject jsonObject)
  • public bool TryGetJsonObjectPropertyValue(string propertyName, StringComparison stringComparison, out JsonObject jsonObject)
  • public bool TryGetPropertyValue(string propertyName, out JsonNode jsonNode)
  • public bool TryGetPropertyValue(string propertyName, StringComparison stringComparison, out JsonNode jsonNode)
• public struct JsonObjectEnumerator : IEnumerator<KeyValuePair<string, JsonNode>>, IEnumerator, IDisposable
  • public KeyValuePair<string, JsonNode> Current { get; }
  • public JsonObjectEnumerator(JsonObject jsonObject)
  • public void Dispose()
  • public bool MoveNext()
• public struct JsonProperty
  • public bool NameEquals(string text)
  • public bool NameEquals(ReadOnlySpan<byte> utf8Text)
  • public bool NameEquals(ReadOnlySpan<char> text)
  • public void WriteTo(Utf8JsonWriter writer)
• public struct JsonReaderState
  • public long BytesConsumed { get; }
  • public SequencePosition Position { get; }
• public static class JsonSerializer
  • public static TValue Deserialize<TValue>(ReadOnlySpan<byte> utf8Json, JsonSerializerOptions options = null)
  • public static object Deserialize(ReadOnlySpan<byte> utf8Json, Type returnType, JsonSerializerOptions options = null)
  • public static TValue Deserialize<TValue>(string json, JsonSerializerOptions options = null)
  • public static object Deserialize(string json, Type returnType, JsonSerializerOptions options = null)
  • public static TValue Deserialize<TValue>(ref Utf8JsonReader reader, JsonSerializerOptions options = null)
  • public static object Deserialize(ref Utf8JsonReader reader, Type returnType, JsonSerializerOptions options = null)
  • public static ValueTask<TValue> DeserializeAsync<TValue>(Stream utf8Json, JsonSerializerOptions options = null, CancellationToken cancellationToken = default)
  • public static ValueTask<object> DeserializeAsync(Stream utf8Json, Type returnType, JsonSerializerOptions options = null, CancellationToken cancellationToken = default)
  • public static string Serialize<TValue>(TValue value, JsonSerializerOptions options = null)
  • public static string Serialize(object value, Type inputType, JsonSerializerOptions options = null)
  • public static void Serialize<TValue>(Utf8JsonWriter writer, TValue value, JsonSerializerOptions options = null)
  • public static void Serialize(Utf8JsonWriter writer, object value, Type inputType, JsonSerializerOptions options = null)
  • public static Task SerializeAsync<TValue>(Stream utf8Json, TValue value, JsonSerializerOptions options = null, CancellationToken cancellationToken = default)
  • public static Task SerializeAsync(Stream utf8Json, object value, Type inputType, JsonSerializerOptions options = null, CancellationToken cancellationToken = default)
  • public static byte[] SerializeToUtf8Bytes<TValue>(TValue value, JsonSerializerOptions options = null)
  • public static byte[] SerializeToUtf8Bytes(object value, Type inputType, JsonSerializerOptions options = null)
• public sealed class JsonSerializerOptions
  • public bool AllowTrailingCommas { get; set; }
  • public IList<JsonConverter> Converters { get; }
  • public int DefaultBufferSize { get; set; }
  • public JsonNamingPolicy DictionaryKeyPolicy { get; set; }
  • public JavaScriptEncoder Encoder { get; set; }
  • public bool IgnoreNullValues { get; set; }
  • public bool IgnoreReadOnlyProperties { get; set; }
  • public int MaxDepth { get; set; }
  • public bool PropertyNameCaseInsensitive { get; set; }
  • public JsonNamingPolicy PropertyNamingPolicy { get; set; }
  • public JsonCommentHandling ReadCommentHandling { get; set; }
  • public ReferenceHandling ReferenceHandling { get; set; }
  • public bool WriteIndented { get; set; }
  • public JsonSerializerOptions()
  • public JsonConverter GetConverter(Type typeToConvert)
• public sealed class JsonString : JsonNode, IEquatable<JsonString>
  • public string Value { get; set; }
  • public JsonString()
  • public JsonString(string value)
  • public JsonString(ReadOnlySpan<char> value)
  • public JsonString(Guid value)
  • public JsonString(DateTime value)
  • public JsonString(DateTimeOffset value)
  • public static bool op_Equality(JsonString left, JsonString right)
  • public static bool op_Inequality(JsonString left, JsonString right)
  • public bool Equals(JsonString other)
  • public DateTime GetDateTime()
  • public DateTimeOffset GetDateTimeOffset()
  • public Guid GetGuid()
  • public bool TryGetDateTime(out DateTime value)
  • public bool TryGetDateTimeOffset(out DateTimeOffset value)
  • public bool TryGetGuid(out Guid value)
• public enum JsonValueType
• public enum JsonValueKind
  • Array = 2
  • False = 6
  • Null = 7
  • Number = 4
  • Object = 1
  • String = 3
  • True = 5
  • Undefined = 0
• public struct JsonWriterOptions
  • public JavaScriptEncoder Encoder { get; set; }
• public struct Utf8JsonReader
  • public bool IsFinalBlock { get; }
  • public Utf8JsonReader(ref ReadOnlySequence jsonData, bool isFinalBlock, JsonReaderState state)
  • public Utf8JsonReader(ReadOnlySpan<byte> jsonData, JsonReaderOptions options = default)
  • public Utf8JsonReader(ReadOnlySequence<byte> jsonData, bool isFinalBlock, JsonReaderState state)
  • public Utf8JsonReader(ReadOnlySequence<byte> jsonData, JsonReaderOptions options = default)
  • public byte GetByte()
  • public byte[] GetBytesFromBase64()
  • public string GetComment()
  • public short GetInt16()
  • public sbyte GetSByte()
  • public ushort GetUInt16()
  • public bool TextEquals(ReadOnlySpan<byte> otherUtf8Text)
  • public bool TextEquals(ReadOnlySpan<char> otherText)
  • public void Skip()
  • public bool TryGetByte(out byte value)
  • public bool TryGetBytesFromBase64(out byte value)
  • public bool TryGetInt16(out short value)
  • public bool TryGetSByte(out sbyte value)
  • public bool TryGetUInt16(out ushort value)
  • public bool TrySkip()
  • public bool ValueTextEquals(ReadOnlySpan<byte> utf8Text)
  • public bool ValueTextEquals(string text)
  • public bool ValueTextEquals(ReadOnlySpan<char> text)
• public sealed class Utf8JsonWriter : IDisposable, IAsyncDisposable
  • public ValueTask DisposeAsync()
  • public void WriteBase64String(JsonEncodedText propertyName, ReadOnlySpan<byte> bytes)
  • public void WriteBase64String(string propertyName, ReadOnlySpan<byte> bytes)
  • public void WriteBase64String(ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> bytes)
  • public void WriteBase64String(ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> bytes)
  • public void WriteBase64StringValue(ReadOnlySpan<byte> bytes)
  • public void WritePropertyName(JsonEncodedText propertyName)
  • public void WritePropertyName(string propertyName)
  • public void WritePropertyName(ReadOnlySpan<char> propertyName)
  • public void WritePropertyName(ReadOnlySpan<byte> utf8PropertyName)

System.Text.Json.Serialization

• public abstract class JsonConverter
  • public abstract bool CanConvert(Type typeToConvert)
• public abstract class JsonConverter<T> : JsonConverter
  • public abstract T Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
  • public abstract void Write(Utf8JsonWriter writer, T value, JsonSerializerOptions options)
• public class JsonConverterAttribute : JsonAttribute
  • public Type ConverterType { get; }
  • public JsonConverterAttribute(Type converterType)
  • protected JsonConverterAttribute()
  • public virtual JsonConverter CreateConverter(Type typeToConvert)
• public abstract class JsonConverterFactory : JsonConverter
  • protected JsonConverterFactory()
  • public abstract JsonConverter CreateConverter(Type typeToConvert, JsonSerializerOptions options)
• public sealed class JsonExtensionDataAttribute : JsonAttribute
  • public JsonExtensionDataAttribute()
• public abstract class JsonNamingPolicy
• public static class JsonSerializer
• public sealed class JsonSerializerOptions
• public sealed class JsonStringEnumConverter : JsonConverterFactory
  • public JsonStringEnumConverter()
  • public JsonStringEnumConverter(JsonNamingPolicy namingPolicy = null, bool allowIntegerValues = true)
• public sealed class ReferenceHandling
  • public static ReferenceHandling Default { get; }
  • public static ReferenceHandling Preserve { get; }