Sparkdo.Json.Newtonsoft
1.0.2
There is a newer prerelease version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package Sparkdo.Json.Newtonsoft --version 1.0.2
NuGet\Install-Package Sparkdo.Json.Newtonsoft -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.Newtonsoft" 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.Newtonsoft" Version="1.0.2" />
<PackageReference Include="Sparkdo.Json.Newtonsoft" />
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.Newtonsoft --version 1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.Json.Newtonsoft, 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.Newtonsoft@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.Newtonsoft&version=1.0.2
#tool nuget:?package=Sparkdo.Json.Newtonsoft&version=1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Sparkdo.Json.Newtonsoft
Sparkdo Newtonsoft.Json模块,提供基于Newtonsoft.Json的JSON序列化和反序列化功能。
功能特性
- 基于Newtonsoft.Json的高性能JSON序列化
- 自定义JSON转换器支持
- 日期时间标准化处理
- 与 Sparkdo 框架无缝集成
安装
<PackageReference Include="Sparkdo.Json.Newtonsoft" Version="x.x.x" />
核心组件
JSON序列化器
SparkdoNewtonsoftJsonSerializer: Newtonsoft.Json序列化器实现
JSON转换器
SparkdoDateTimeConverter: 日期时间转换器
合约解析器
SparkdoCamelCasePropertyNamesContractResolver: 驼峰命名法属性名合约解析器SparkdoDefaultContractResolver: 默认合约解析器
使用方法
基本序列化
// 注入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);
}
}
扩展性
该库提供了完整的Newtonsoft.Json功能实现,可以通过以下方式扩展:
- 实现自定义的
JsonConverter来提供特定类型的序列化逻辑 - 实现自定义的
ContractResolver来提供合约解析逻辑 - 实现自定义的JSON序列化选项
代码结构说明
本项目包含以下主要组件:
JSON序列化核心
SparkdoNewtonsoftJsonSerializer: JSON序列化器实现,提供序列化和反序列化功能SparkdoNewtonsoftJsonSerializerOptions: JSON序列化选项,配置序列化器行为
JSON转换器
SparkdoDateTimeConverter: 日期时间转换器,支持时区标准化
合约解析器
SparkdoCamelCasePropertyNamesContractResolver: 驼峰命名法属性名合约解析器SparkdoDefaultContractResolver: 默认合约解析器,为日期时间属性应用自定义转换器
所有公共接口和类都添加了详细的 XML 文档注释,便于开发者理解和使用。
| Product | Versions 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)
- Newtonsoft.Json (>= 13.0.4)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Json.Abstractions (>= 1.0.2)
- Sparkdo.Timing (>= 1.0.2)
- System.Linq.Dynamic.Core (>= 1.7.1)
- TimeZoneConverter (>= 7.2.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.3-preview.1 | 39 | 5/17/2026 |
| 1.0.2 | 100 | 4/27/2026 |
| 1.0.2-preview.5 | 51 | 4/15/2026 |
| 1.0.2-preview.4 | 72 | 2/8/2026 |
| 1.0.2-preview.3 | 67 | 2/1/2026 |
| 1.0.2-preview.2 | 66 | 1/31/2026 |
| 1.0.2-preview.1 | 171 | 12/4/2025 |
| 1.0.1 | 215 | 11/27/2025 |
| 1.0.0 | 216 | 11/25/2025 |
| 1.0.0-preview.5 | 137 | 10/24/2025 |