关于c＃：如何在Json.NET输出中添加注释？


How do I add comments to Json.NET output?

有没有办法可以自动添加注释到JSON.Net的序列化输出？

理想情况下，我认为它类似于以下内容：

1
2
3
4
5
public class MyClass
{
    [JsonComment("My documentation string")]
    public string MyString { get; set; }
}

或者(如果可以避免注释，则更好)：

1
2
3
4
5
6
7
public class MyClass
{
    /// <summary>
    /// My documentation string
    /// </summary>
    public string MyString { get; set; }
}

会产生：

1
2
3
4
{
    //My documentation string
   "MyString":"Test"
}

我问的原因是我们使用Json.NET来序列化配置文件，以后可以手动更改。 我想在我的C＃配置类中包含文档，并在JSON中重现这些文档，以帮助以后可能需要更改文件的人。

更新：正如RoToRa在下面指出的那样，在JSON规范中技术上不允许发表评论(请参阅http://www.json.org上方便的语法图)。 但是，Json.NET站点上的功能表包括：

Supports reading and writing comments

并且存在输出注释的Newtonsoft.Json.JsonTextWriter.WriteComment(string)。 我对创建注释的整洁方式感兴趣，而不是直接使用JsonTextWriter。

相关讨论

序列化时，Json.NET JsonSerializer不会自动输出注释。 如果你想要评论，你需要手动编写你的JSON，使用JsonTextWriter或LINQ to JSON

相关讨论

问题是JSON作为文件格式不支持注释。 您可以做的一件事 - 如果阅读JSON文件的应用程序允许它 - 使用其他属性作为此问题中建议的注释：可以在JSON中使用注释吗？

正如@RoToRa已经说过，JSON不允许发表评论。

如果您仍想要注释，并且想要输出正确的JSON，则可以通过更改数据布局将注释作为实际JSON数据的一部分。 例如：

1
2
3
4
5
6
{
   "MyString": {
       "doc":  "My documentation string",
       "value":"Test"
    }
}