System.Xml.XmlValidatingReader.ReadAttributeValue 方法

方法描述

将特性值分析为一个或多个 Text、EntityReference 或 EndEntity 节点。

语法定义(C# System.Xml.XmlValidatingReader.ReadAttributeValue 方法 的用法)

public override bool ReadAttributeValue()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 System.Boolean 如果有可返回的节点，则为 true。 如果进行初始调用时读取器不是定位在特性节点上，或者如果已读取了所有特性值，则为 false。 如果是空特性（如 misc=""），则返回 true，同时为 String.Empty 的单个节点。

提示和注释

注意

XmlValidatingReader 类在 .NET Framework 2.0 版中已过时。 您可以使用 XmlReaderSettings 类和 Create 方法创建一个验证 XmlReader 实例。 有关更多信息，请参见 使用 XmlReader 验证 XML 数据。

调用 MoveToAttribute 后，使用此方法读取通过组成特性值的文本或实体引用节点。 特性值节点的 Depth 为 1 加上该特性节点的深度。 当您进入和跳出常规实体引用时，Depth 按 1 递增和递减。

例如，假设您有以下 XML：

其中实体 b 是在文档类型定义 (DTD) 中定义的，定义形式如下：

如果 EntityHandling 设置为 ExpandCharEntities，下面的 C# 代码以两个文本节点和一个实体引用节点的形式返回特性值：

复制

reader.MoveToAttribute("name");

while (reader.ReadAttributeValue())

{

if (reader.NodeType == XmlNodeType.Text)

{

// at this point reader.Value == "a " or " c"

}

else if (reader.NodeType == XmlNodeType.EntityReference)

{

// at this point reader.Name == "b"

reader.ResolveEntity();

while (reader.ReadAttributeValue() &&

reader.NodeType != XmlNodeType.EndEntity)

{

// reader.Value == "123"

}

}

}

System.Xml.XmlValidatingReader.ReadAttributeValue 方法例子

下面的示例读取具有文本或实体引用节点的特性。

using System;
using System.IO;
using System.Xml;

public class Sample 
{
  public static void Main()
  {
    XmlValidatingReader reader = null;

    try
    {
       //Create the XML fragment to be parsed.
       string xmlFrag ="";

       //Create the XmlParserContext.
       XmlParserContext context;
       string subset = "";
       context = new XmlParserContext(null, null, "book", null, null, subset, "", "", XmlSpace.None);

       //Create the reader and set it to not expand general entities. 
       reader = new XmlValidatingReader(xmlFrag, XmlNodeType.Element, context);
       reader.ValidationType = ValidationType.None;
       reader.EntityHandling = EntityHandling.ExpandCharEntities;

       //Read the misc attribute. Because EntityHandling is set to
       //ExpandCharEntities, the attribute is parsed into multiple text
       //and entity reference nodes.
       reader.MoveToContent();
       reader.MoveToAttribute("misc");
       while (reader.ReadAttributeValue()){
          if (reader.NodeType==XmlNodeType.EntityReference)
            //To expand the entity, call ResolveEntity.
            Console.WriteLine("{0} {1}", reader.NodeType, reader.Name);
          else
             Console.WriteLine("{0} {1}", reader.NodeType, reader.Value);
        } 
     } 
     finally 
     {
        if (reader != null)
          reader.Close();
      }
  }
} // End class

异常

异常 异常描述

命名空间

namespace: System.Xml

程序集: System.Xml（在 System.Xml.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

相关资源

XmlValidatingReader 类
System.Xml 命名空间
用 XmlReader 读取 XML
MSDN