QJSON 新版中增加了对注释保存的支持,早先版本的 QJSON 对于注释会自动跳过,不会保存注释的内容。但这一功能在 StrictJson 为 true 时不会支持,以兼容更多的解析器。
QJSON 中,注释的保存通过 CommentStyle 属性来控制:
- jcsIgnore : 忽略掉注释,保存时不会保存注释的内容;
- jcsInherited : 继承上一级的注释保存方式(默认),如果自己是最上一级,则为 jcsIgnore。
- jcsBeforeName : 在结点的名称前写入注释
- jcsAfterValue : 在结束的值后面写入注释
要读写结点的注释内容,可以通过 Comment 属性。
【注意】
QJSON 会解析文件中的注释并赋值给 Comment 属性,但是不会自动设置相关结点的 CommentStyle 属性,所以,如果需要保存注释,在保存前,一定要设置 QJSON 对象的 CommentStyle 属性为 jcsBefreName 或 jcsAfterValue 之一。