<PackageReference Include="System.Text.Json" Version="9.0.0-preview.7.24405.7" />

---

API Differences between 9.0.0-preview.7.24405.7 and 7.0.0-preview.4.22229.4

227 Additions 7 Removals

System.Runtime.InteropServices

• public static class JsonMarshal
  • public static ReadOnlySpan<byte> GetRawUtf8Value(JsonElement element)

System.Text.Json

• public struct JsonElement
  • public static bool DeepEquals(JsonElement element1, JsonElement element2)
• public struct JsonEncodedText : IEquatable<JsonEncodedText>
  • public string Value { get; }
• public abstract class JsonNamingPolicy
  • public static JsonNamingPolicy KebabCaseLower { get; }
  • public static JsonNamingPolicy KebabCaseUpper { get; }
  • public static JsonNamingPolicy SnakeCaseLower { get; }
  • public static JsonNamingPolicy SnakeCaseUpper { get; }
• public struct JsonReaderOptions
  • public bool AllowMultipleValues { get; set; }
• public static class JsonSerializer
  • public static bool IsReflectionEnabledByDefault { get; }
  • public static object Deserialize(this JsonDocument document, JsonTypeInfo jsonTypeInfo)
  • public static object Deserialize(this JsonElement element, JsonTypeInfo jsonTypeInfo)
  • public static object Deserialize(this JsonNode node, JsonTypeInfo jsonTypeInfo)
  • public static object Deserialize(ReadOnlySpan<byte> utf8Json, JsonTypeInfo jsonTypeInfo)
  • public static object Deserialize(Stream utf8Json, JsonTypeInfo jsonTypeInfo)
  • public static object Deserialize(string json, JsonTypeInfo jsonTypeInfo)
  • public static object Deserialize(ReadOnlySpan<char> json, JsonTypeInfo jsonTypeInfo)
  • public static object Deserialize(ref Utf8JsonReader reader, JsonTypeInfo jsonTypeInfo)
  • public static ValueTask<object> DeserializeAsync(Stream utf8Json, JsonTypeInfo jsonTypeInfo, CancellationToken cancellationToken = default)
  • public static IAsyncEnumerable<TValue> DeserializeAsyncEnumerable<TValue>(Stream utf8Json, bool topLevelValues, JsonSerializerOptions options = null, CancellationToken cancellationToken = default)
  • public static IAsyncEnumerable<TValue> DeserializeAsyncEnumerable<TValue>(Stream utf8Json, JsonTypeInfo<TValue> jsonTypeInfo, CancellationToken cancellationToken = default)
  • public static IAsyncEnumerable<TValue> DeserializeAsyncEnumerable<TValue>(Stream utf8Json, JsonTypeInfo<TValue> jsonTypeInfo, bool topLevelValues, CancellationToken cancellationToken = default)
  • public static void Serialize(Stream utf8Json, object value, JsonTypeInfo jsonTypeInfo)
  • public static string Serialize(object value, JsonTypeInfo jsonTypeInfo)
  • public static void Serialize(Utf8JsonWriter writer, object value, JsonTypeInfo jsonTypeInfo)
  • public static Task SerializeAsync(Stream utf8Json, object value, JsonTypeInfo jsonTypeInfo, CancellationToken cancellationToken = default)
  • public static Task SerializeAsync<TValue>(PipeWriter utf8Json, TValue value, JsonTypeInfo<TValue> jsonTypeInfo, CancellationToken cancellationToken = default)
  • public static Task SerializeAsync<TValue>(PipeWriter utf8Json, TValue value, JsonSerializerOptions options = null, CancellationToken cancellationToken = default)
  • public static Task SerializeAsync(PipeWriter utf8Json, object value, JsonTypeInfo jsonTypeInfo, CancellationToken cancellationToken = default)
  • public static Task SerializeAsync(PipeWriter utf8Json, object value, Type inputType, JsonSerializerContext context, CancellationToken cancellationToken = default)
  • public static Task SerializeAsync(PipeWriter utf8Json, object value, Type inputType, JsonSerializerOptions options = null, CancellationToken cancellationToken = default)
  • public static JsonDocument SerializeToDocument(object value, JsonTypeInfo jsonTypeInfo)
  • public static JsonElement SerializeToElement(object value, JsonTypeInfo jsonTypeInfo)
  • public static JsonNode SerializeToNode(object value, JsonTypeInfo jsonTypeInfo)
  • public static byte[] SerializeToUtf8Bytes(object value, JsonTypeInfo jsonTypeInfo)
• public sealed class JsonSerializerOptions
  • public static JsonSerializerOptions Web { get; }
  • public bool AllowOutOfOrderMetadataProperties { get; set; }
  • public char IndentCharacter { get; set; }
  • public int IndentSize { get; set; }
  • public bool IsReadOnly { get; }
  • public string NewLine { get; set; }
  • public IList<JsonPolymorphicTypeConfiguration> PolymorphicTypeConfigurations { get; }
  • public JsonObjectCreationHandling PreferredObjectCreationHandling { get; set; }
  • public bool RespectNullableAnnotations { get; set; }
  • public bool RespectRequiredConstructorParameters { get; set; }
  • public IJsonTypeInfoResolver TypeInfoResolver { get; set; }
  • public IList<IJsonTypeInfoResolver> TypeInfoResolverChain { get; }
  • public JsonUnmappedMemberHandling UnmappedMemberHandling { get; set; }
  • public JsonTypeInfo GetTypeInfo(Type type)
  • public void MakeReadOnly()
  • public void MakeReadOnly(bool populateMissingResolver)
  • public bool TryGetTypeInfo(Type type, out JsonTypeInfo typeInfo)
• public struct JsonWriterOptions
  • public char IndentCharacter { get; set; }
  • public int IndentSize { get; set; }
  • public string NewLine { get; set; }
• public struct Utf8JsonReader
  • public bool ValueIsEscaped { get; }
  • public int CopyString(Span<byte> utf8Destination)
  • public int CopyString(Span<char> destination)
• public sealed class Utf8JsonWriter : IDisposable, IAsyncDisposable
  • public void WriteRawValue(ReadOnlySequence<byte> utf8Json, bool skipInputValidation = false)

System.Text.Json.Nodes

• public sealed class JsonArray : JsonNode, IList<JsonNode>, ICollection<JsonNode>, IEnumerable<JsonNode>, IEnumerable
  • public JsonArray(JsonNodeOptions options, ReadOnlySpan<JsonNode> items)
  • public JsonArray(ReadOnlySpan<JsonNode> items)
  • public IEnumerable<T> GetValues<T>()
• public abstract class JsonNode
  • public static bool DeepEquals(JsonNode node1, JsonNode node2)
  • public static Task<JsonNode> ParseAsync(Stream utf8Json, JsonNodeOptions? nodeOptions = default, JsonDocumentOptions documentOptions = default, CancellationToken cancellationToken = default)
  • public JsonNode DeepClone()
  • public int GetElementIndex()
  • public string GetPropertyName()
  • public JsonValueKind GetValueKind()
  • public void ReplaceWith<T>(T value)
• public sealed class JsonObject : JsonNode, IDictionary<string, JsonNode>, ICollection<KeyValuePair<string, JsonNode>>, IEnumerable<KeyValuePair<string, JsonNode>>, IEnumerable, IList<KeyValuePair<string, JsonNode>>
  • public KeyValuePair<string, JsonNode> GetAt(int index)
  • public int IndexOf(string propertyName)
  • public void Insert(int index, string propertyName, JsonNode value)
  • public void RemoveAt(int index)
  • public void SetAt(int index, string propertyName, JsonNode value)
  • public void SetAt(int index, JsonNode value)

System.Text.Json.Schema

• public static class JsonSchemaExporter
  • public static JsonNode GetJsonSchemaAsNode(this JsonSerializerOptions options, Type type, JsonSchemaExporterOptions exporterOptions = null)
  • public static JsonNode GetJsonSchemaAsNode(this JsonTypeInfo typeInfo, JsonSchemaExporterOptions exporterOptions = null)
• public struct JsonSchemaExporterContext
  • public JsonTypeInfo BaseTypeInfo { get; }
  • public ReadOnlySpan<string> Path { get; }
  • public JsonPropertyInfo PropertyInfo { get; }
  • public JsonTypeInfo TypeInfo { get; }
• public sealed class JsonSchemaExporterOptions
  • public static JsonSchemaExporterOptions Default { get; }
  • public Func<JsonSchemaExporterContext, JsonNode, JsonNode> TransformSchemaNode { get; set; }
  • public bool TreatNullObliviousAsNonNullable { get; set; }
  • public JsonSchemaExporterOptions()

System.Text.Json.Serialization

• public abstract class JsonConverter
  • public abstract Type Type { get; }
• public class JsonDerivedTypeAttribute : JsonAttribute
  • public string TypeDiscriminatorId { get; }
  • public object TypeDiscriminator { get; }
  • public JsonDerivedTypeAttribute(Type derivedType, int typeDiscriminator)
• public enum JsonKnownNamingPolicy
  • KebabCaseLower = 4
  • KebabCaseUpper = 5
  • SnakeCaseLower = 2
  • SnakeCaseUpper = 3
• public sealed class JsonNumberEnumConverter<TEnum> : JsonConverterFactory where TEnum : struct, Enum
  • public JsonNumberEnumConverter()
• public enum JsonObjectCreationHandling
  • Populate = 1
  • Replace = 0
• public sealed class JsonObjectCreationHandlingAttribute : JsonAttribute
  • public JsonObjectCreationHandling Handling { get; }
  • public JsonObjectCreationHandlingAttribute(JsonObjectCreationHandling handling)
• public sealed class JsonPolymorphicAttribute : JsonAttribute
  • public string CustomTypeDiscriminatorPropertyName { get; set; }
  • public string TypeDiscriminatorPropertyName { get; set; }
• public class JsonPolymorphicTypeConfiguration : IJsonPolymorphicTypeConfiguration, ICollection<ValueTuple<Type, string>>, IEnumerable<ValueTuple<Type, string>>, IEnumerable
• public class JsonPolymorphicTypeConfiguration<TBaseType> : JsonPolymorphicTypeConfiguration
• public sealed class JsonRequiredAttribute : JsonAttribute
  • public JsonRequiredAttribute()
• public sealed class JsonSourceGenerationOptionsAttribute : JsonAttribute
  • public bool AllowOutOfOrderMetadataProperties { get; set; }
  • public bool AllowTrailingCommas { get; set; }
  • public Type[] Converters { get; set; }
  • public int DefaultBufferSize { get; set; }
  • public JsonKnownNamingPolicy DictionaryKeyPolicy { get; set; }
  • public char IndentCharacter { get; set; }
  • public int IndentSize { get; set; }
  • public int MaxDepth { get; set; }
  • public string NewLine { get; set; }
  • public JsonNumberHandling NumberHandling { get; set; }
  • public JsonObjectCreationHandling PreferredObjectCreationHandling { get; set; }
  • public bool PropertyNameCaseInsensitive { get; set; }
  • public JsonCommentHandling ReadCommentHandling { get; set; }
  • public bool RespectNullableAnnotations { get; set; }
  • public bool RespectRequiredConstructorParameters { get; set; }
  • public JsonUnknownTypeHandling UnknownTypeHandling { get; set; }
  • public JsonUnmappedMemberHandling UnmappedMemberHandling { get; set; }
  • public bool UseStringEnumConverter { get; set; }
  • public JsonSourceGenerationOptionsAttribute(JsonSerializerDefaults defaults)
• public class JsonStringEnumConverter<TEnum> : JsonConverterFactory where TEnum : struct, Enum
  • public JsonStringEnumConverter()
  • public JsonStringEnumConverter(JsonNamingPolicy namingPolicy = null, bool allowIntegerValues = true)
• public class JsonStringEnumMemberNameAttribute : Attribute
  • public string Name { get; }
  • public JsonStringEnumMemberNameAttribute(string name)
• public enum JsonUnknownDerivedTypeHandling
  • FallbackToBaseType = 1
  • FallbackToNearestAncestor = 2
  • FallBackToBaseType = 1
  • FallBackToNearestAncestor = 2
• public enum JsonUnmappedMemberHandling
  • Disallow = 1
  • Skip = 0
• public class JsonUnmappedMemberHandlingAttribute : JsonAttribute
  • public JsonUnmappedMemberHandling UnmappedMemberHandling { get; }
  • public JsonUnmappedMemberHandlingAttribute(JsonUnmappedMemberHandling unmappedMemberHandling)

System.Text.Json.Serialization.Metadata

• public class DefaultJsonTypeInfoResolver : IJsonTypeInfoResolver, IBuiltInJsonTypeInfoResolver
  • public IList<Action<JsonTypeInfo>> Modifiers { get; }
  • public DefaultJsonTypeInfoResolver()
  • public virtual JsonTypeInfo GetTypeInfo(Type type, JsonSerializerOptions options)
• public interface IJsonTypeInfoResolver
  • JsonTypeInfo GetTypeInfo(Type type, JsonSerializerOptions options)
• public struct JsonDerivedType
  • public Type DerivedType { get; }
  • public object TypeDiscriminator { get; }
  • public JsonDerivedType(Type derivedType)
  • public JsonDerivedType(Type derivedType, int typeDiscriminator)
  • public JsonDerivedType(Type derivedType, string typeDiscriminator)
• public static class JsonMetadataServices
  • public static JsonConverter<JsonDocument> JsonDocumentConverter { get; }
  • public static JsonConverter<Memory<byte>> MemoryByteConverter { get; }
  • public static JsonConverter<ReadOnlyMemory<byte>> ReadOnlyMemoryByteConverter { get; }
  • public static JsonTypeInfo<TCollection> CreateIAsyncEnumerableInfo<TCollection, TElement>(JsonSerializerOptions options, JsonCollectionInfoValues<TCollection> collectionInfo) where TCollection : IAsyncEnumerable<TElement>
  • public static JsonTypeInfo<Memory<TElement>> CreateMemoryInfo<TElement>(JsonSerializerOptions options, JsonCollectionInfoValues<Memory<TElement>> collectionInfo)
  • public static JsonTypeInfo<ReadOnlyMemory<TElement>> CreateReadOnlyMemoryInfo<TElement>(JsonSerializerOptions options, JsonCollectionInfoValues<ReadOnlyMemory<TElement>> collectionInfo)
  • public static JsonConverter<T?> GetNullableConverter<T>(JsonSerializerOptions options) where T : struct
• public sealed class JsonObjectInfoValues<T>
  • public Func<ICustomAttributeProvider> ConstructorAttributeProviderFactory { get; set; }
• public abstract class JsonParameterInfo
  • public ICustomAttributeProvider AttributeProvider { get; }
  • public Type DeclaringType { get; }
  • public object DefaultValue { get; }
  • public bool HasDefaultValue { get; }
  • public bool IsMemberInitializer { get; }
  • public bool IsNullable { get; }
  • public string Name { get; }
  • public Type ParameterType { get; }
  • public int Position { get; }
• public sealed class JsonParameterInfoValues
  • public bool IsMemberInitializer { get; set; }
  • public bool IsNullable { get; set; }
• public class JsonPolymorphismOptions
  • public IList<JsonDerivedType> DerivedTypes { get; }
  • public bool IgnoreUnrecognizedTypeDiscriminators { get; set; }
  • public string TypeDiscriminatorPropertyName { get; set; }
  • public JsonUnknownDerivedTypeHandling UnknownDerivedTypeHandling { get; set; }
  • public JsonPolymorphismOptions()
• public abstract class JsonPropertyInfo
  • public JsonParameterInfo AssociatedParameter { get; }
  • public ICustomAttributeProvider AttributeProvider { get; set; }
  • public JsonConverter CustomConverter { get; set; }
  • public Type DeclaringType { get; }
  • public Func<object, object> Get { get; set; }
  • public bool IsExtensionData { get; set; }
  • public bool IsGetNullable { get; set; }
  • public bool IsRequired { get; set; }
  • public bool IsSetNullable { get; set; }
  • public string Name { get; set; }
  • public JsonNumberHandling? NumberHandling { get; set; }
  • public JsonObjectCreationHandling? ObjectCreationHandling { get; set; }
  • public JsonSerializerOptions Options { get; }
  • public int Order { get; set; }
  • public Type PropertyType { get; }
  • public Action<object, object> Set { get; set; }
  • public Func<object, object, bool> ShouldSerialize { get; set; }
• public sealed class JsonPropertyInfoValues<T>
  • public Func<ICustomAttributeProvider> AttributeProviderFactory { get; set; }
• public abstract class JsonTypeInfo
  • public ICustomAttributeProvider ConstructorAttributeProvider { get; }
  • public JsonConverter Converter { get; }
  • public Func<object> CreateObject { get; set; }
  • public Type ElementType { get; }
  • public bool IsReadOnly { get; }
  • public Type KeyType { get; }
  • public JsonTypeInfoKind Kind { get; }
  • public JsonNumberHandling? NumberHandling { get; set; }
  • public Action<object> OnDeserialized { get; set; }
  • public Action<object> OnDeserializing { get; set; }
  • public Action<object> OnSerialized { get; set; }
  • public Action<object> OnSerializing { get; set; }
  • public JsonSerializerOptions Options { get; }
  • public IJsonTypeInfoResolver OriginatingResolver { get; set; }
  • public JsonPolymorphismOptions PolymorphismOptions { get; set; }
  • public JsonObjectCreationHandling? PreferredPropertyObjectCreationHandling { get; set; }
  • public IList<JsonPropertyInfo> Properties { get; }
  • public Type Type { get; }
  • public JsonUnmappedMemberHandling? UnmappedMemberHandling { get; set; }
  • public static JsonTypeInfo<T> CreateJsonTypeInfo<T>(JsonSerializerOptions options)
  • public static JsonTypeInfo CreateJsonTypeInfo(Type type, JsonSerializerOptions options)
  • public JsonPropertyInfo CreateJsonPropertyInfo(Type propertyType, string name)
  • public void MakeReadOnly()
• public sealed class JsonTypeInfo<T> : JsonTypeInfo
  • public Func<T> CreateObject { get; set; }
• public enum JsonTypeInfoKind
  • Dictionary = 3
  • Enumerable = 2
  • None = 0
  • Object = 1
• public static class JsonTypeInfoResolver
  • public static IJsonTypeInfoResolver Combine(IJsonTypeInfoResolver[] resolvers)
  • public static IJsonTypeInfoResolver Combine(ReadOnlySpan<IJsonTypeInfoResolver> resolvers)
  • public static IJsonTypeInfoResolver WithAddedModifier(this IJsonTypeInfoResolver resolver, Action<JsonTypeInfo> modifier)