SerializIt 0.6.13

<p align="center"> <img src ="https://raw.githubusercontent.com/KhaosCoders/SerializIt/master/Art/Icon.png" width=200 /> </p>

SerializIt

使用 Roslyn SourceGenerators 替代反射的超快速序列化器

仅支持序列化，不支持反序列化！

支持的序列化器

• JSON
• YAML
• (基本) XML

安装

您可以在 nuget.org 上找到此软件包。

使用包管理器控制台安装 SerializIt

Install-Package SerializIt

或终端

dotnet add package SerializIt 

用法

创建您想要序列化的模型。
然后创建如下所示的 partial 序列化上下文

using SerializIt;
using Samples.Model;

namespace Samples
{
    [Serializer(ESerializers.Yaml)]
    [YamlOptions(indentChars: "  ")]
    [SerializeType(typeof(RootElement))]
    [SerializeType(typeof(Container))]
    [SerializeType(typeof(Info))]
    internal partial class YamlContext { }
}

此上下文将为每个定义的类型添加序列化器。

通过调用 SerializeDocument (或 SerializeElement) 方法来序列化对象实例。

// var root = new RootElement();

var serializeIt = new YamlContext();
string text = serializeIt.RootElement.SerializeDocument(root);

以本存储库中的 _samples 项目为例。

序列化应该非常快！

基准测试

此基准测试比较了 SerializIt 的 JSON、YAML 和 XML 序列化与其他常见库，如 Tinyhand、System.Text.Json、YamlDotNet 和 System.Xml.Serialization。该基准测试在我的 HP 笔记本（16GB 内存、Intel i7-8565U、SSD）上运行。

结论

SerializIt 很快。但是，如果你想序列化和反序列化 JSON，你最好使用 System.Text.Json 中的 源生成器。但是，如果你要在 YAML 或 XML 进行序列化，SerializIt 是最佳选择。它比这个基准测试中使用的常见库将这些格式序列化得更快。

备注

SerializIt 只进行序列化。目前还没有反序列化功能。因此，如果你需要反序列化某些 YAML 或 XML，你仍然最好选择提到的库，因为它们也提供反序列化功能。此外，SerializIt 伴随的 XML 序列化器处于 alpha 阶段，最多如此。需要做大量工作，才能使其成为有用的序列化器。

特性

此序列化器支持以下特性

• 格式：JSON，YAML，（基本）XML
• PrettyPrint（JSON/XML）：开启/关闭
• 自定义缩进 - 默认为制表符
• 可以跳过定义的属性
• 可以跳过具有默认值的属性
• 可以排序属性

待改进

[ ] 值转换器（序列化复杂数据类型，如 GUID 或 BitInteger）
[ ] 自定义序列化器（支持自定义格式）
[ ] 序列化特定成员选项（如 XML 中的 CDATA 或 Yaml & Json 中的 Inline）
[ ] XML 命名空间
[ ] XML 属性

点赞这个 ❤️

如果你喜欢我的工作，请支持这个项目！
通过 PayPal 捐赠或成为 GitHub 赞助人