Sparkdo.Json.SystemTextJson 1.0.2

There is a newer prerelease version of this package available.
See the version list below for details.

dotnet add package Sparkdo.Json.SystemTextJson --version 1.0.2

NuGet\Install-Package Sparkdo.Json.SystemTextJson -Version 1.0.2

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.2" />

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.2" />
                    

                            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.2

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

#r "nuget: Sparkdo.Json.SystemTextJson, 1.0.2"

#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.2

#: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.2
                    

                            Install as a Cake Addin

#tool nuget:?package=Sparkdo.Json.SystemTextJson&version=1.0.2
                    

                            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.5)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.5)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.5)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.5)
- Microsoft.Extensions.Configuration.Json (>= 10.0.5)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyModel (>= 10.0.5)
- Microsoft.Extensions.FileProviders.Composite (>= 10.0.5)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.5)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Localization (>= 10.0.5)
- Microsoft.Extensions.Logging (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.5)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.5)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Json.Abstractions (>= 1.0.2)
- Sparkdo.ObjectExtending (>= 1.0.2)
- Sparkdo.Timing (>= 1.0.2)
- System.Linq.Dynamic.Core (>= 1.7.1)
- TimeZoneConverter (>= 7.2.0)

NuGet packages (3)

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

Package	Downloads
Sparkdo.Json Sparkdo 框架的 JSON 处理库。提供统一的 JSON 序列化和反序列化接口。	4.1K
Sparkdo.FeatureManagement.Domain.Shared Sparkdo 功能管理共享领域层，提供功能管理模块的共享资源、常量定义和数据传输对象	1.3K
Sparkdo.Caching.Hybrid Sparkdo 混合缓存库，提供基于 Microsoft.Extensions.Caching.Hybrid 的混合缓存功能实现	1.2K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.3-preview.1	101	5/17/2026
1.0.2	474	4/27/2026
1.0.2-preview.5	111	4/15/2026
1.0.2-preview.4	113	2/8/2026
1.0.2-preview.3	117	2/1/2026
1.0.2-preview.2	137	1/31/2026
1.0.2-preview.1	204	12/4/2025
1.0.1	1,353	11/27/2025
1.0.0	1,317	11/25/2025
1.0.0-preview.5	153	10/24/2025

Sparkdo.Json.SystemTextJson 1.0.2

Sparkdo.Json.SystemTextJson

功能特性

安装

核心组件

JSON序列化器

JSON转换器

JSON修饰符

使用方法

基本序列化

自定义转换器

使用修饰符

扩展性

代码结构说明

JSON序列化核心

JSON转换器

JSON修饰符

net10.0

NuGet packages (3)

GitHub repositories