[转载]Json.net说法——(一)修饰标签,日期序列化 – 梅桦 – 博客园.
通过属性标签自定义JSON序列化
JsonObjectAttribute:类修饰标签,用于控制类如何被序列化为一个json对象
JsonArrayAttribute:集合修饰标签,用于控制集合如何被序列化为一个json对象
JsonPropertyAttribute:域和属性修饰标签,用于控制它们如何被序列化为一个json对象中的属性
JsonConverterAttribute:类,域,属性修饰标签,用于指定序列化期间的转换器
示例代码:
[JsonObject(MemberSerialization.OptIn)] public class Customer { [JsonProperty(PropertyName="ID")] public int Unid { get; set; } [JsonProperty] public string CustomerName { get; set; } [JsonProperty] [JsonConverter(typeof(IsoDateTimeConverter))] public DateTime CreateTime { get; set; } public string Memo { get; set; } }
JsonObjectAttribute
这个标签的成员序列化标志指定成员序列化是opt-in(要序列化的成员必须带有JsonProperty或DataMember标签)还是opt-out(默认所有的都会序列化,但通过JsonIgnoreAttribute标签可以忽略序列化。opt-out是json.net默认的)。
JsonPropertyAttribute
允许被序列化的成员自定义名字。这个标签同时标示出:在成员序列化设置为opt-in的时候,成员会被序列化。
JsonIgnoreAttribute
忽略域或属性的序列化
JsonConverterAttribute
用于指派转换对象的JsonSerializer。
这个标签可以修饰类或类成员。用于修饰类时,通过此标签指派的JsonConverter会被设置为序列化类的默认方式。用于修饰属性或域成员时,被指派的JsonConverter会序列化它们的值。
序列化日期
json中的日期是困难的。这个问题来源于json细则本身,因为在json中没有日期的原义句法。这个细则包括对象,数组,字符串,整型和浮点,但它没有对日期定义相关的标准。在json.net中用于日期的默认的格式与微软:“\/Date(1198908717056)\/”这个一样。
DateTime JsonConverters
因为在json中没有关于日期的标准,在系统间的互操作过程中出现了大量不同的格式。幸运的是json.net提供了用于读写自定义日期格式的解决方案:JsonConverters。一个json转换器用于指定一种类型如何被序列化。
public class LogEntry { public string Details { get; set; } public DateTime LogDate { get; set; } } public void WriteJsonDates() { LogEntry entry = new LogEntry { LogDate = new DateTime(2009, 2, 15, 0, 0, 0, DateTimeKind.Utc), Details = "Application started." }; string defaultJson = JsonConvert.SerializeObject(entry); // {"Details":"Application started.","LogDate":"\/Date(1234656000000)\/"} string javascriptJson = JsonConvert.SerializeObject(entry, new JavaScriptDateTimeConverter()); // {"Details":"Application started.","LogDate":new Date(1234656000000)} string isoJson = JsonConvert.SerializeObject(entry, new IsoDateTimeConverter()); // {"Details":"Application started.","LogDate":"2009-02-15T00:00:00Z"} }
JavaScriptDateTimeConverter
这个来自json.net的转换器是两种日期转换器之一。它是把日期序列化为一个js日期对象。
new Date(1234656000000)
IsoDateTimeConverter
这种转换器把日期序列化为一个ISO8601格式的字符串。
“2009-02-15T00:00:00Z”
这个类有一个日期格式化属性,用于自定义其它的格式字符串。