Sparkdo.Json.SystemTextJson 1.0.4-preview.3

This is a prerelease version of Sparkdo.Json.SystemTextJson.

dotnet add package Sparkdo.Json.SystemTextJson --version 1.0.4-preview.3

NuGet\Install-Package Sparkdo.Json.SystemTextJson -Version 1.0.4-preview.3

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Sparkdo.Json.SystemTextJson" Version="1.0.4-preview.3" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Sparkdo.Json.SystemTextJson" Version="1.0.4-preview.3" />
                    

                            Directory.Packages.props

<PackageReference Include="Sparkdo.Json.SystemTextJson" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Sparkdo.Json.SystemTextJson --version 1.0.4-preview.3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Sparkdo.Json.SystemTextJson, 1.0.4-preview.3"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Sparkdo.Json.SystemTextJson@1.0.4-preview.3

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Sparkdo.Json.SystemTextJson&version=1.0.4-preview.3&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=Sparkdo.Json.SystemTextJson&version=1.0.4-preview.3&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Sparkdo.Json.SystemTextJson

Sparkdo SystemTextJson模块，提供基于System.Text.Json的JSON序列化和反序列化功能。

功能特性

基于System.Text.Json的高性能JSON序列化
自定义JSON转换器支持
日期时间标准化处理
枚举序列化支持
扩展属性序列化支持
与 Sparkdo 框架无缝集成

安装

<PackageReference Include="Sparkdo.Json.SystemTextJson" Version="x.x.x" />

核心组件

JSON序列化器

SparkdoSystemTextJsonSerializer: SystemTextJson序列化器实现

JSON转换器

ObjectToInferredTypesConverter: 对象到推断类型转换器
SparkdoDateTimeConverter: 日期时间转换器
SparkdoNullableDateTimeConverter: 可空日期时间转换器
SparkdoStringToBooleanConverter: 字符串到布尔值转换器
SparkdoStringToEnumConverter: 字符串到枚举转换器
SparkdoStringToEnumFactory: 字符串到枚举转换器工厂
SparkdoStringToGuidConverter: 字符串到Guid转换器
SparkdoNullableStringToGuidConverter: 可空字符串到Guid转换器

JSON修饰符

SparkdoDateTimeConverterModifier: 日期时间转换器修饰符
SparkdoIgnorePropertiesModifiers: 忽略属性修饰符
SparkdoIncludeExtraPropertiesModifiers: 包含额外属性修饰符
SparkdoIncludeNonPublicPropertiesModifiers: 包含非公共属性修饰符

使用方法

基本序列化

// 注入JSON序列化器
public class MyService
{
    private readonly IJsonSerializer _jsonSerializer;
    
    public MyService(IJsonSerializer jsonSerializer)
    {
        _jsonSerializer = jsonSerializer;
    }
    
    public string SerializeObject()
    {
        var obj = new MyObject { Name = "Test", Value = 123 };
        return _jsonSerializer.Serialize(obj);
    }
    
    public MyObject DeserializeObject(string json)
    {
        return _jsonSerializer.Deserialize<MyObject>(json);
    }
}

自定义转换器

// 添加自定义转换器
public override void Configure(IConfigureContext context)
{
    context.Services.AddOptions<SparkdoSystemTextJsonSerializerOptions>()
        .Configure(options =>
        {
            options.JsonSerializerOptions.Converters.Add(new MyCustomConverter());
        });
}

使用修饰符

// 配置JSON修饰符
public override void Configure(IConfigureContext context)
{
    context.Services.AddOptions<SparkdoSystemTextJsonSerializerModifiersOptions>()
        .Configure(options =>
        {
            options.Modifiers.Add(new MyCustomModifier().CreateModifyAction());
        });
}

扩展性

该库提供了完整的SystemTextJson功能实现，可以通过以下方式扩展：

实现自定义的 JsonConverter 来提供特定类型的序列化逻辑
实现自定义的 JsonConverterFactory 来提供转换器工厂
实现自定义的修饰符来修改序列化行为
实现自定义的JSON序列化选项

代码结构说明

本项目包含以下主要组件：

JSON序列化核心

SparkdoSystemTextJsonSerializer: JSON序列化器实现，提供序列化和反序列化功能
SparkdoSystemTextJsonSerializerOptions: JSON序列化选项，配置序列化器行为
SparkdoDefaultJsonTypeInfoResolver: 默认JSON类型信息解析器

JSON转换器

ObjectToInferredTypesConverter: 对象到推断类型转换器，处理动态类型
SparkdoDateTimeConverter: 日期时间转换器，支持时区标准化
SparkdoNullableDateTimeConverter: 可空日期时间转换器
SparkdoStringToBooleanConverter: 字符串到布尔值转换器
SparkdoStringToEnumConverter: 字符串到枚举转换器
SparkdoStringToEnumFactory: 字符串到枚举转换器工厂
SparkdoStringToGuidConverter: 字符串到Guid转换器
SparkdoNullableStringToGuidConverter: 可空字符串到Guid转换器

JSON修饰符

SparkdoDateTimeConverterModifier: 日期时间转换器修饰符，为日期时间属性应用自定义转换器
SparkdoIgnorePropertiesModifiers: 忽略属性修饰符，忽略指定属性的序列化
SparkdoIncludeExtraPropertiesModifiers: 包含额外属性修饰符，处理扩展属性的序列化
SparkdoIncludeNonPublicPropertiesModifiers: 包含非公共属性修饰符，处理非公共属性的序列化

所有公共接口和类都添加了详细的 XML 文档注释，便于开发者理解和使用。

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.Extensions.Configuration (>= 10.0.8)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.8)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.8)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.8)
- Microsoft.Extensions.Configuration.Json (>= 10.0.8)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.8)
- Microsoft.Extensions.DependencyInjection (>= 10.0.8)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.8)
- Microsoft.Extensions.DependencyModel (>= 10.0.8)
- Microsoft.Extensions.FileProviders.Composite (>= 10.0.8)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.8)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.8)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.8)
- Microsoft.Extensions.Localization (>= 10.0.8)
- Microsoft.Extensions.Logging (>= 10.0.8)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.8)
- Microsoft.Extensions.Options (>= 10.0.8)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.8)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.8)
- Microsoft.Extensions.Primitives (>= 10.0.8)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Json.Abstractions (>= 1.0.4-preview.3)
- Sparkdo.ObjectExtending (>= 1.0.4-preview.3)
- Sparkdo.Timing (>= 1.0.4-preview.3)
- System.Linq.Dynamic.Core (>= 1.7.2)
- TimeZoneConverter (>= 7.2.0)

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Sparkdo.Json.SystemTextJson:

Package	Downloads
Sparkdo.FeatureManagement.Domain.Shared Sparkdo 功能管理共享领域层，提供功能管理模块的共享资源、常量定义和数据传输对象	1.8K
Sparkdo.Caching.Hybrid Sparkdo 混合缓存库，提供基于 Microsoft.Extensions.Caching.Hybrid 的混合缓存功能实现	1.3K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.4-preview.3	287	6/8/2026
1.0.4-preview.2	277	6/7/2026
1.0.4-preview.1	253	6/7/2026
1.0.3	599	6/6/2026
1.0.3-preview.1	269	5/17/2026
1.0.2	492	4/27/2026
1.0.2-preview.5	127	4/15/2026
1.0.2-preview.4	122	2/8/2026
1.0.2-preview.3	128	2/1/2026
1.0.2-preview.2	145	1/31/2026
1.0.2-preview.1	216	12/4/2025
1.0.1	1,365	11/27/2025
1.0.0	1,327	11/25/2025
1.0.0-preview.5	161	10/24/2025

Sparkdo.Json.SystemTextJson 1.0.4-preview.3

Sparkdo.Json.SystemTextJson

功能特性

安装

核心组件

JSON序列化器

JSON转换器

JSON修饰符

使用方法

基本序列化

自定义转换器

使用修饰符

扩展性

代码结构说明

JSON序列化核心

JSON转换器

JSON修饰符

net10.0

NuGet packages (2)

GitHub repositories