.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();
}
}