XmlReader.ReadElementContentAsObject 方法

参考

定义

命名空间:: System.Xml

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

读取当前元素并将内容作为 Object 返回。

重载

ReadElementContentAsObject()	读取当前元素并将内容作为 Object 返回。
ReadElementContentAsObject(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Object 返回。

ReadElementContentAsObject()

读取当前元素并将内容作为 Object 返回。

public:
 virtual System::Object ^ ReadElementContentAsObject();

public virtual object ReadElementContentAsObject ();

abstract member ReadElementContentAsObject : unit -> obj
override this.ReadElementContentAsObject : unit -> obj

Public Overridable Function ReadElementContentAsObject () As Object

Object

一个最适当类型的装箱的公共语言运行时 (CLR) 对象。 ValueType 属性确定了适当的 CLR 类型。如果将内容类型化为列表类型，则此方法返回一个适当类型的装箱对象的数组。

例外

InvalidOperationException

XmlReader 未定位在元素上。

或 -

在上一次异步操作完成之前调用了 XmlReader 方法。在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

XmlException

当前元素包含子元素。

或 -

无法将元素内容转换成请求的类型

ArgumentNullException

使用 null 参数调用此方法。

示例

以下示例使用该方法读取节点的内容 price 。读取器使用架构中的信息将内容映射到正确的数据类型。

// Create a validating reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:items", "item.xsd");	
 XmlReader reader = XmlReader.Create("item.xml", settings);

// Get the CLR type of the price element.
reader.ReadToFollowing("price");
Console.WriteLine(reader.ValueType);

// Return the value of the price element as Decimal object.
Decimal price = (Decimal) reader.ReadElementContentAsObject();

// Add 2.50 to the price.
price = Decimal.Add(price, 2.50m);

' Create a validating reader.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:items", "item.xsd")
Dim reader As XmlReader = XmlReader.Create("item.xml", settings)
      
' Get the CLR type of the price element. 
reader.ReadToFollowing("price")
Console.WriteLine(reader.ValueType)
      
' Return the value of the price element as Decimal object.
Dim price As [Decimal] = CType(reader.ReadElementContentAsObject(), [Decimal])
      
' Add 2.50 to the price.
price = [Decimal].Add(price, 2.5D)

此示例使用以下两个文件作为输入。

item.xml

<item xmlns="urn:items" productID='123098'>
 <name>hammer</name>
 <price>9.95</price>
 <supplierID>1929</supplierID>
</item>

item.xsd

<?xml version="1.0"?>
<xs:schema xmlns:tns="urn:items" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="urn:items" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="item">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="name" type="xs:string" />
        <xs:element name="price" type="xs:decimal" />
        <xs:element name="supplierID" type="xs:unsignedShort" />
      </xs:sequence>
      <xs:attribute name="productID" type="xs:unsignedInt" use="required" />
    </xs:complexType>
  </xs:element>
</xs:schema>

注解

此方法读取起始标记、元素的内容，并将读取器移到结束元素标记之后。它扩展实体并忽略处理指令和注释。元素只能包含简单内容。也就是说，它不能有子元素。

有关详细信息，请参阅参考页的 XmlReader “备注”部分和 W3C XML 架构第 2 部分：数据类型建议。

有关此方法的异步版本，请参阅 ReadElementContentAsObjectAsync。

适用于

ReadElementContentAsObject(String, String)

检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Object 返回。

public:
 virtual System::Object ^ ReadElementContentAsObject(System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAsObject (string localName, string namespaceURI);

abstract member ReadElementContentAsObject : string * string -> obj
override this.ReadElementContentAsObject : string * string -> obj

Public Overridable Function ReadElementContentAsObject (localName As String, namespaceURI As String) As Object

参数

localName: String

元素的本地名称。

namespaceURI: String

元素的命名空间 URI。

Object

例外