.Net Framework提供了对应的System.Xml.Seriazliation.XmlSerializer负责把对象序列化到XML,和从XML中反序列化为对象。Serializer的使用比较直观,需要多注意的是XML序列化相关的Attribute,怎么把这些attribute应用到我们的对象,以及对象公共属性上面去,生成满足预期格式的XML。
需求来源于一文件转换项目,将一个XML格式的文件转换成另一种格式。公司的框架也大量使用了XmlSerializer来处理系统里大量配置,每一个文件配置文件对应一种类型的多个配置项。
关键知识点
序列化常用Attribute讲解说明:
[XmlRootAttribute("MyCity", Namespace="abc.abc", IsNullable=false)] // 当该类为Xml根节点时,以此为根节点名称。
public class City
[XmlAttribute("AreaName")] // 表现为Xml节点属性。<... AreaName="..."/>
public string Name
[XmlElementAttribute("AreaId", IsNullable = false)] // 表现为Xml节点。<AreaId>...</AreaId>
public string Id
[XmlArrayAttribute("Areas")] // 表现为Xml层次结构,根为Areas,其所属的每个该集合节点元素名为类名。<Areas><Area ... /><Area ... /></Areas>
public Area[] Areas
[XmlElementAttribute("Area", IsNullable = false)] // 表现为水平结构的Xml节点。<Area ... /><Area ... />...
public Area[] Areas
[XmlIgnoreAttribute] // 忽略该元素的序列化。
实际案例
类定义:
1) OrderEntity单据类XML里是最顶层的Root节点。
/// <summary>/// 订单信息/// </summary>[Serializable][XmlRoot("Document")]public class OrderEntity{[XmlArray("Events"), XmlArrayItem("Event")]public OrderEvent[] Event { get; set; } }
2) OrderEvent单据类型(事件)描述实体
/// <summary>/// 单据类型(事件)描述信息/// </summary>[Serializable] public class OrderEvent{/// <summary>/// 单据名称/// </summary>[XmlAttribute("Name")]public string Name { get; set; }/// <summary>/// 库存动作/// </summary>[XmlAttribute("MainAction")]public string MainAction { get; set; }/// <summary>/// 单据明细项/// </summary>[XmlArray("DataField"), XmlArrayItem("Data")]public OrderDetail[] details { get; set; }}
3)、数据明细类
/// <summary>/// 单据明细项目/// </summary>[Serializable]public class OrderDetail{[XmlAttribute("Code")]public string Code { get; set; }[XmlAttribute("Actor")]public string Actor { get; set; }[XmlAttribute("ActDate")]public string ActDate { get; set; }[XmlAttribute("CorpOrderID")]public string CorpOrderID { get; set; }[XmlAttribute("FromCorpID")]public string FromCorpID { get; set; }[XmlAttribute("ToCorpID")]public string ToCorpID { get; set; }[XmlAttribute("OwnerID")]public string OwnerID { get; set; }}
4)序列化的实际代码
#region 初始化订单对象并完成序列化OrderEntity result_File_Object = new OrderEntity{Event = new OrderEvent[] {new OrderEvent{Name =orderName ,MainAction= dt_Event.Rows[0]["MainAction"].ToString(),details = query.Where(d => d.Code!=string.Empty).ToList().ToArray()}}};Program.SerializerToXML<OrderEntity>(path + "\\" + fileName, result_File_Object);#endregion
/// <summary>/// 把对象序列化成xml文件/// </summary>/// <typeparam name="T">对象的类</typeparam>/// <param name="outFile">输出的文件和路径</param>/// <param name="t">对象的实例</param>public static void SerializerToXML<T>(string outFile, T t) where T : class{using (System.IO.FileStream fs = new System.IO.FileStream(outFile, System.IO.FileMode.Create)){XmlSerializerNamespaces ns = new XmlSerializerNamespaces();ns.Add("", "");XmlSerializer xs = new XmlSerializer(typeof(T));xs.Serialize(fs, t, ns);fs.Flush();}}