用C#读xml文档(流模型)

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 对实体的引用  &num;
---------------------------------------------------------------------
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="中国" 年代="当代">余秋雨&amp;</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)指示没有可用的架构信息。