C# XML序列化方法及常用特性总结分析
本文实例总结了C#XML序列化方法及常用特性。分享给大家供大家参考,具体如下:
C#对象XML序列化(一):序列化方法和常用特性
.NetFramework提供了对应的System.Xml.Seriazliation.XmlSerializer负责把对象序列化到XML,和从XML中反序列化为对象。Serializer的使用比较直观,需要多注意的是XML序列化相关的Attribute,怎么把这些attribute应用到我们的对象,以及对象公共属性上面去,生成满足预期格式的XML。
这里列出了最常用的方法和特性,涵盖日常大部分的转换工作,希望大家在工作中快速上手。为了给大家直观的印象,这里给出具体的使用代码,为了节省篇幅,代码异常处理没有添加,各位同学使用的时候酌情添加。
1.Serializer方法
下面的方法封装了XmlSerializer的调用,这里列出了参数最全的一个版本,具体使用的时候需适当添加重载:
publicstaticclassXmlSerializer
{
publicstaticvoidSaveToXml(stringfilePath,objectsourceObj,Typetype,stringxmlRootName)
{
if(!string.IsNullOrWhiteSpace(filePath)&&sourceObj!=null)
{
type=type!=null?type:sourceObj.GetType();
using(StreamWriterwriter=newStreamWriter(filePath))
{
System.Xml.Serialization.XmlSerializerxmlSerializer=string.IsNullOrWhiteSpace(xmlRootName)?
newSystem.Xml.Serialization.XmlSerializer(type):
newSystem.Xml.Serialization.XmlSerializer(type,newXmlRootAttribute(xmlRootName));
xmlSerializer.Serialize(writer,sourceObj);
}
}
}
publicstaticobjectLoadFromXml(stringfilePath,Typetype)
{
objectresult=null;
if(File.Exists(filePath))
{
using(StreamReaderreader=newStreamReader(filePath))
{
System.Xml.Serialization.XmlSerializerxmlSerializer=newSystem.Xml.Serialization.XmlSerializer(type);
result=xmlSerializer.Deserialize(reader);
}
}
returnresult;
}
}
2.序列化常用Attribute讲解说明:
[XmlRootAttribute("MyCity",Namespace="abc.abc",IsNullable=false)]//当该类为Xml根节点时,以此为根节点名称。
publicclassCity
[XmlAttribute("AreaName")]//表现为Xml节点属性。<...AreaName="..."/>
publicstringName
[XmlElementAttribute("AreaId",IsNullable=false)]//表现为Xml节点。<AreaId>...</AreaId>
publicstringId
[XmlArrayAttribute("Areas")]//表现为Xml层次结构,根为Areas,其所属的每个该集合节点元素名为类名。<Areas><Area.../><Area.../></Areas>
publicArea[]Areas
[XmlElementAttribute("Area",IsNullable=false)]//表现为水平结构的Xml节点。<Area.../><Area.../>...
publicArea[]Areas
[XmlIgnoreAttribute]//忽略该元素的序列化。
3.详细举例说明
这里用简单的城市,区域和街区作为例子,具体示范一下上面的规则。
[XmlRootAttribute("MyCity",Namespace="abc.abc",IsNullable=false)]
publicclassCity
{
[XmlAttribute("CityName")]
publicstringName
{
get;
set;
}
[XmlAttribute("CityId")]
publicstringId
{
get;
set;
}
[XmlArrayAttribute("Areas")]
publicArea[]Areas
{
get;
set;
}
}
[XmlRootAttribute("MyArea")]
publicclassArea
{
[XmlAttribute("AreaName")]
publicstringName
{
get;
set;
}
[XmlElementAttribute("AreaId",IsNullable=false)]
publicstringId
{
get;
set;
}
[XmlElementAttribute("Street",IsNullable=false)]
publicstring[]Streets
{
get;
set;
}
}
根据以上类型,我们mock一些数据,然后用步骤1给出的Util方法输出:
staticvoidMain(string[]args)
{
Areaarea1=newArea();
area1.Name="Pudong";
area1.Id="PD001";
area1.Streets=newstring[]{"street001","street002"};
Areaarea2=newArea();
area2.Name="Xuhui";
area2.Id="XH002";
area2.Streets=newstring[]{"street003","street004"};
Citycity1=newCity();
city1.Name="Shanghai";
city1.Id="SH001";
city1.Areas=newArea[]{area1,area2};
XmlSerializer.SaveToXml(@"C:\temp\XML\output003.xml",city1);
}
最终输出的XML为:
<?xmlversion="1.0"encoding="utf-8"?> <MyCityxmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" CityName="Shanghai"CityId="SH001"xmlns="abc.abc"> <Areas> <AreaAreaName="Pudong"> <AreaId>PD001</AreaId> <Street>street001</Street> <Street>street002</Street> </Area> <AreaAreaName="Xuhui"> <AreaId>XH002</AreaId> <Street>street003</Street> <Street>street004</Street> </Area> </Areas> </MyCity>
下面我们开始具体分析结果,其中包含一些很有用的结论和注意事项:
1.xml的版本,编码,以及命名空间xmlns:xsi,xmlns:xsd为Framework自动添加。
2.因为我们用City对象作为根节点,所以根节点名称为我们定义的"MyCity"。
但是,注意!这里指的是用City自身直接做根节点,如果是City集合比如City[],此时,该名称失效,系统会自动生成名称ArrayOfCity作为根节点名称(ArrayOf+类名),或者我们手动指定名称,这个就是在给大家的SaveToXml()方法中,参数xmlRootName的作用。
3.如果以City为根节点并在XmlRootAttribute特性中给定名称,同时也手动指定了xmlRootName,系统会以手动指定的名称为准。
4.AreaName,AreaId,同为Area类的公共属性,一个被解释成属性,一个被解释成子节点。
Areas集合被解释成了层次结构,Streets集合被解释成了水平结构。
这两组区别最能体现不同序列化Attribute的用法。
PS:小编这里再来为大家推荐几款关于xml操作的在线工具供大家免费使用。相信在以后开发中可以用的到:
在线XML格式化/压缩工具:
http://tools.jb51.net/code/xmlformat
在线XML/JSON互相转换工具:
http://tools.jb51.net/code/xmljson
xml代码在线格式化美化工具:
http://tools.jb51.net/code/xmlcodeformat
HTML/XML转义字符对照表:
http://tools.jb51.net/table/html_escape
更多关于C#相关内容感兴趣的读者可查看本站专题:《C#中XML文件操作技巧汇总》、《C#常见控件用法教程》、《WinForm控件用法总结》、《C#数据结构与算法教程》、《C#面向对象程序设计入门教程》及《C#程序设计之线程使用技巧总结》
希望本文所述对大家C#程序设计有所帮助。