System.Xml命名空间下,XmlReader和XmlWriter类是用于读写xml文档的抽象类,它们使用流模型
使用XmlReader类读XML文档,它提供对XML数据的快速、非缓存、只向前、只读的访问。
1.XmlReader有3个子类:
1)XmlTextReader:最快的 XmlReader 实现。它检查 XML 格式是否正确,但不支持验证。该读取器不能展开常规实体(dtd中的概念),不支持默认属性。
XmlReader 在发生 XML 分析错误时引发 XmlException 异常。
2)XmlValidatingReader: 可以使用 DTD 或 Schema 验证数据的 XmlReader 的实现。该读取器还可以展开常规实体并支持默认属性。
3)XmlNodeReader: 从 XmlNode 读取 XML 数据的 XmlReader 的实现
注:读xml文档,一般使用XmlTextReader类
===================================================
2.XmlTextReader 类
1)XmlTextReader把xml文档看作是一个序列化的节点集合,即一个节点流
2)xml文档中的 元素的开始标记(节点类型为Element)、元素的属性(Attribute)、元素的文本内容(Text)、标记之间的空白/换行(SignificantWhitespace或Whitespace)、元素的结束标记(EndElement)等 都被视为节点。
3)Read()方法是XmlTextReader类的主要实例方法,它执行一次就读节点流中的一个节点
但Read()方法不会自动读取属性节点(Attribute类型的节点),如果当前节点是Element节点后,下一次被读的节点就是Text(如果当前元素有文本内容)或Whitespace节点(如果当前节点标记预下一个标记之间有空白/换行的话,如果没有空白换行,就没有Whitespace节点)
即Read()方法只会读Element、Text、Whitespace、EndElement等类型的节点
3)如果当前当前节点是Element节点,如果想读元素的属性节点的话,可以使用以下方法:
MoveToAttribute 、MoveToFirstAttribute 、MoveToNextAttribute 等
如果当前节点是Attribute节点,要回到属性所属元素的节点上的话,可使用MoveToElement 方法
4)随着当前节点的节点类型的不同,XmlReader类对象的某些属性也会无效
例如XmlTextReader对象的AttributeCount属性,对于不是Element、DocumentType 和 XmlDeclaration 类型的节点来说,该属性无意义
5)关于SignificantWhitespace/Whitespace节点的处理:
XmlTextReader对象的WhitespaceHandling属性可以指定如何处理空白
3.节点的类型
=====================================================================
节点类型 说明 示例 XML
=====================================================================
Attribute 属性 id='123'
---------------------------------------------------------------------
CDATA CDATA节 <![CDATA[my escaped text]]>
---------------------------------------------------------------------
Comment 注释 <!-- my comment -->
---------------------------------------------------------------------
Document 作为文档树的根的文档对象提供对整个 XML 文档的访问
---------------------------------------------------------------------
DocumentFragment 文档片段
---------------------------------------------------------------------
DocumentType 文档类型声明 <!DOCTYPE ...>
---------------------------------------------------------------------
Element 元素 <item>
---------------------------------------------------------------------
EndElement 结束元素标记 </item>
---------------------------------------------------------------------
EndEntity 由于调用 ResolveEntity 而使 XmlReader 到达实体替换的末尾时返回
---------------------------------------------------------------------
Entity 实体声明 <!ENTITY ...>
---------------------------------------------------------------------
EntityReference 对实体的引用 #
---------------------------------------------------------------------
None 如果未调用 Read 方法,则由 XmlReader 返回
---------------------------------------------------------------------
Notation 文档类型声明中的表示法 <!NOTATION ...>
---------------------------------------------------------------------
ProcessingInstruction 处理指令 <?pi test?>
---------------------------------------------------------------------
SignificantWhitespace 混合内容模型中标记间的空白或 xml:space="preserve"范围内的空白
---------------------------------------------------------------------
Text 节点的文本内容。可以以Attribute、DocumentFragment、Element、 EntityReference 节点的子节点的形式出现
---------------------------------------------------------------------
Whitespace 标记间的空白
---------------------------------------------------------------------
XmlDeclaration XML 声明 <?xml version='1.0'?>
=====================================================================
4.XmlTextReader应用示例:读一个xml文档-tmp.xml
文档tmp.xml的内容:
-----------------------------------------------------------------------
<?xml version="1.0" encoding="GB2312"?>
<bookstore>
<book name="文化苦旅">
<author nation="中国" 年代="当代">余秋雨&</author>
<price>32</price>
<press>华夏出版社</press>
</book>
</bookstore>
//文档有一个空白尾行
------------------------------------------------------------------------
C#代码:
------------------------------------------------------------------------
XmlTextReader xr4 = new XmlTextReader("temp.xml"); //装载整个文档到内存
xr4.WhitespaceHandling = WhitespaceHandling.All; //设置如何处理空白节点
while(xr4.Read())
{
Console.Write((" Type: " + xr4.NodeType).PadRight(20)); //打印节点类型
Console.Write((" Name: " + xr4.Name).PadRight(18)); //打印节点名称
Console.WriteLine(" Value: " + xr4.Value); //打印节点的值
if (xr4.HasAttributes) //如果当前节点有属性的话(非元素节点的此属性为null)
{
int tmp = xr4.AttributeCount;
for (int i = 0; i < tmp; i++ ) //循环打印元素节点的属性
{
xr4.MoveToAttribute(i); //移动到第n个属性上
Console.WriteLine((" Type: " + xr4.NodeType).PadRight(20)
+ (" Name: " + xr4.Name).PadRight(16)
+ (" value: " + xr4.Value.PadRight(10))
+ (" AttributeCount: " + xr4.AttributeCount) );
xr4.MoveToElement(); //回到元素节点
}
}
}
xr4.Close(); //关闭流对象
Console.ReadLine();
------------------------------------------------------------------------
输出:
----------------------------------------------------------------------------------
Type: XmlDeclaration Name: xml Value: version="1.0" encoding="GB2312"
Type: Attribute Name: version value: 1.0 AttributeCount: 2
Type: Attribute Name: encoding value: GB2312 AttributeCount: 2
Type: Whitespace Name: Value:
Type: Element Name: bookstore Value: //该节点没有属性,AttributeCount为null
Type: Whitespace Name: Value: //该节点没有属性,AttributeCount为null
Type: Element Name: book Value:
Type: Attribute Name: name value: 文化苦旅 AttributeCount: 1
Type: Whitespace Name: Value:
Type: Element Name: author Value:
Type: Attribute Name: nation value: 中国 AttributeCount: 2
Type: Attribute Name: 年代 value: 当代 AttributeCount: 2
Type: Text Name: Value: 余秋雨&
Type: EndElement Name: author Value:
Type: Whitespace Name: Value:
Type: Element Name: price Value:
Type: Text Name: Value: 32
Type: EndElement Name: price Value:
Type: Whitespace Name: Value:
Type: Element Name: press Value:
Type: Text Name: Value: 华夏出版社
Type: EndElement Name: press Value:
Type: Whitespace Name: Value:
Type: EndElement Name: book Value: //即book元素的结束标记</book>
Type: Whitespace Name: Value:
Type: EndElement Name: bookstore Value: //即结束标记</bookstore>
Type: Whitespace Name: Value: //文档的空白尾行
----------------------------------------------------------------------------------
5.XmlTextReader类的常用方法
1)在元素节点和属性节点之间移动
如果当前节点是元素节点,并且该元素拥有属性的话:
·使用MoveToAttribute()方法可以移动到属性节点,该方法要求指定属性名或属性的位置
·使用MoveToFirstAttribute()方法可以移动到第一个属性上,并返回true
·如果当前节点是元素节点,使用MoveToNextAttribute()方法等效于MoveToFirstAttribute方法。
如果已经移动到了属性节点上,并且存在下一个属性,调用该方法就会移动到下一个属性节点上
否则,读取器位置不变并返回false
如果读取器定位在属性上,使用MoveToElement()方法,则当前节点移动到属性所属的元素节点上。
2)跳过内容-两种方法
·一种方法是调用使用 MoveToContent 方法直接移动到内容节点
MoveToContent()方法检查当前节点以查看它是否是内容节点。
内容节点被定义为任意 Text、CDATA、Element、EndElement、EntityReference 或 EndEntity 节点。如果当前节点不是前述内容节点的类型之一,则将跳过该节点并跳到下一个内容节点或文件结尾。
它一直跳,直到找到下一个内容节点或到文件的结尾才停止。
如果当前节点是一个属性节点,则此方法将读取器移回拥有该属性的元素。
示例:
-----------------------------------------------------------------------------
if (reader.MoveToContent() == XmlNodeType.Element && reader.Name == "price")
{
_price = reader.ReadString();
}
-----------------------------------------------------------------------------
·另一种方法是直接调用 Skip 方法,该方法从当前节点跳过所有子节点到下一个同级节点
如果当前节点类型为XmlNodeType.Element,则调用skip方法将跳到同级的下一个节点上。
如果当前节点是属性节点,则调用skip方法将跳到属性所属元素节点的下一个同级节点上。
3)读方法
·Read()方法:如果成功读取了下一个节点,则为true;如果没有其他节点可读取,则为false
第一次创建和初始化读取器时,没有可用的信息。必须调用 Read() 读取第一个节点。
·ReadStartElement()方法:
检查当前节点是否为元素(类型为Element的节点)并将读取器推进到下一个节点
·ReadEndElement()方法:
检查当前节点是否为结束标记(类型为EndElement的节点)并将读取器推进到下一个节点
·ReadAttributeValue()方法:
将当前属性节点的属性值分解为一个或多个 Text、EntityReference 或 EndEntity 节点。
如果有可返回的节点,则返回true。如果进行初始调用时读取器不是定位在属性节点上,或者如果已读取了所有属性值,则返回false
如果是空属性(如 misc=""),则返回true,同时将属性值分解为 String.Empty 的单个节点
一般,当读取器移动到一个属性节点上后,通过循环调用ReadAttributeValue方法来分解属性的值
示例:读xml文档 <book genre='novel' misc='sale-item &h; 1987'></book>
---------------------------------------------------------------------
.......
reader.MoveToAttribute("misc"); //移动到属性misc上
while (reader.ReadAttributeValue()) //misc属性值包含实体应用,属性值被分解
{ //分解完属性值后,循环结束
if (reader.NodeType==XmlNodeType.EntityReference) //遇到实体引用节点
Console.WriteLine("{0} {1}", reader.NodeType, reader.Name);
else
Console.WriteLine("{0} {1}", reader.NodeType, reader.Value);
}
--------------------------------------------------------------------
4)使用字符流进行完整的内容读取
方法ReadChars、ReadBinHex、ReadBase64用于读取大型的流。ReadChars方法原样读取文本 (US-ASCII),ReadBase64方法解码Base64编码的文本,而ReadBinHex方法则解码binhex编码的数据。
ReadChars、ReadBinHex和ReadBase64方法只能用在元素上。在其他节点类型上使用这些方法不起作用
这三个方法都返回元素的开始标记和结束标记之间的所有内容,包括所有标记,就像在读出流一样。
·ReadChars方法: public int ReadChars(char[] buffer,int index,int count);
将元素的内容读入字符缓冲区。通过连续调用此方法,可以读取当前元素的非常大的嵌入文本流
此方法设计只用于元素节点。其他节点类型导致ReadChars返回0
此方法返回元素的实际字符内容,返回元素开始标记和结束标记之间的所有内容,包括标记
ReadChars方法忽略格式不正确的XML标记
当ReadChars方法已到达字符流的结尾时,它返回值0并且将读取器定位在结束标记之后
·ReadBase64方法: public int ReadBase64(byte[] array,int offset,int len);
和ReadChars方法一样,可以连续调用此方法以读取大的嵌入文本流。
它对Base64内容进行解码,并将解码的二进制字节(例如内联Base64编码的GIF图像)返回到缓冲区中
·ReadBinHex方法: public int ReadBinHex(byte[] array,int offset,int len);
与 ReadChars 一样,可以连续调用此方法以读取大的嵌入文本流。
它对BinHex内容进行解码并将解码的二进制字节(例如内联BinHex编码的GIF图像)返回到缓冲区中
5)读取字符内容
·ReadElementString方法:读取简单文本元素的方法
调用ReadElementString方法时,读取器将移动到下一个节点并读取其简单文本内容,如果该节点不是简单文本元素,则会报错。读取完之后,读取器将再向下移动一个节点
·ReadString方法:元素或文本节点的内容当做字符串读取
如果读取器定位在元素或文本节点以外的位置,或者当前上下文中没有其他文本内容,则返回空字符串
·ReadInnerXml方法:将节点的所有内容(包括子元素、文本内容等)当做字符串读取
如果当前读取器位于开始标记,则该方法返回开始标记与对应的结束标记之间所有的内容
如果当前读取器位于属性节点,则该方法返回属性的值
如果当前节点既非元素,也非属性,则返回空字符串
·ReadOuterXml方法:此方法类似于 ReadInnerXml,但它还返回开始标记和结束标记
如果当前读取器位于开始标记,则该方法返回 <开始标记>..内容..<结束标记/> 字符串
如果当前读取器位于属性节点,则该方法返回 属性名="属性值" 字符串
如果当前节点既非元素,也非属性,则返回空字符串
===================================================
2.XmlValidatingReader类
1)XmlValidatingReader类是一个能够提供 DTD、XDR 和 XSD 验证的读取器,能够提供数据验证、解析常规实体的能力和对默认属性的支持,该类也是继承自 XmlReader 类。
2)XmlValidatingReader类基本上类似于XmlTextReader类,但它增加了ValidationType、Schema和 SchemaType、XmlResolver 等新的属性
·ValidationType属性指示验证的类型,其值域为:Auto,DTD,Schema,XDR,None
·Schema属性用于需要多个xdr或xsd参与验证的情况,Schema属性实质上是一个XmlSchemaCollection
·SchemaType属性返回当前节点的类型:XSD内置类型、用户自定义类型(simpleType/complexType)
·XmlResolver属性用于解析外部实体(比如DTD中定义的外部实体)
3)使用XmlValidatingReader类进行验证的最佳操作:
·创建一个XmlTextReader对象tr,将tr对象传给XmlValidatingReader构造函数生成一个对象trv
·设置XmlValidatingReader类型对象trv的ValidationType属性(默认值为Auto)
·为事件ValidationEventHandler定义和分配事件处理方法ValidationEvent
trv.ValidationEventHandler += new ValidationEventHandler(this.ValidationEvent)
因为如果验证出错误时,就会引发trv对象的ValidationEventHandler事件,需要对该事件进行处理
·像使用XmlTextReader类对象那样使用XmlValidatingReader对象trv
4)仅当在调用Read、ReadInnerXml、ReadOuterXml或Skip方法的过程中,且XmlValidatingReader对象trv的ValidationType属性不是ValidationType.None时,才可能发生ValidationEventHandler验证事件
如果不提供ValidationEventHandler事件的处理程序,当遇到级别为Warning的验证错误时,仍会继续读取数据不引发异常。当遇到第一个级别为Error的验证错误时,XmlValidatingReader对象trv将会引发异常XmlException,之后trv对象也将无法重新启动。
当根据架构或DTD进行验证时,如果发生验证错误,也将引发XmlSchemaException异常
如果某个元素报告验证错误,则不验证该元素其余的内容模型,但是将验证其子级。读取器只报告给定元素的第一个错误
ValidationEventHandler事件处理程序可以使用ValidationEventArgs类对象e的Severity属性来保证根据架构验证了XML实例文档。Severity属性可以区分验证错误和验证警告,验证错误(Severity 等于 XmlSeverityType.Error)表示致命错误,而验证警告(Severity 等于 XmlSeverityType.Warning)指示没有可用的架构信息。