XmlReader.ReadElementContentAsObject Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Beolvassa az aktuális elemet, és visszaadja a tartalmat Object.

Túlterhelések

Name	Description
ReadElementContentAsObject()	Beolvassa az aktuális elemet, és visszaadja a tartalmat Object.
ReadElementContentAsObject(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd beolvassa az aktuális elemet, és visszaadja a tartalmat Object.

ReadElementContentAsObject()

Forrás:

XmlReader.cs

Beolvassa az aktuális elemet, és visszaadja a tartalmat 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

Válaszok

Object

A legmegfelelőbb típusú, dobozos közös nyelvi futtatókörnyezet (CLR) objektum. A ValueType tulajdonság határozza meg a megfelelő CLR-típust. Ha a tartalom listatípusként van begépelve, ez a metódus a megfelelő típusú dobozos objektumok tömbét adja vissza.

Kivételek

InvalidOperationException

Az XmlReader elem nincs elemen elhelyezve.

-vagy-

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

XmlException

Az aktuális elem gyermekelemeket tartalmaz.

-vagy-

Az elem tartalma nem konvertálható a kért típusra

ArgumentNullException

A metódus argumentumokkal van null meghívva.

Példák

Az alábbi példa a csomópont tartalmának olvasására használja a metódust price . Az olvasó a séma információi alapján megfelelteti a tartalmat a megfelelő adattípusnak.

// 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)

A példa a következő két fájlt használja bemenetként.

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>

Megjegyzések

Ez a metódus felolvassa a kezdőcímkét, az elem tartalmát, és áthelyezi az olvasót a záróelem címkéje mellett. Kibővíti az entitásokat, és figyelmen kívül hagyja a feldolgozási utasításokat és megjegyzéseket. Az elem csak egyszerű tartalmat tartalmazhat. Vagyis nem rendelkezhet gyermekelemekkel.

További információkért tekintse meg a referenciaoldal Megjegyzések szakaszát XmlReader és a W3C XML-séma 2. részét: Adattípusokra vonatkozó javaslatot.

A metódus aszinkron verziójáról lásd ReadElementContentAsObjectAsync: .

ReadElementContentAsObject(String, String)

Forrás:

XmlReader.cs

Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elemével, majd beolvassa az aktuális elemet, és visszaadja a tartalmat 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

Paraméterek

localName

String

Az elem helyi neve.

namespaceURI

String

Az elem névterének URI-ja.

Válaszok

Object

A legmegfelelőbb típusú, dobozos közös nyelvi futtatókörnyezet (CLR) objektum. A ValueType tulajdonság határozza meg a megfelelő CLR-típust. Ha a tartalom listatípusként van begépelve, ez a metódus a megfelelő típusú dobozos objektumok tömbét adja vissza.

Kivételek

InvalidOperationException

Az XmlReader elem nincs elemen elhelyezve.

-vagy-

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

XmlException

Az aktuális elem gyermekelemeket tartalmaz.

-vagy-

Az elem tartalma nem konvertálható a kért típusra.

ArgumentNullException

A metódus argumentumokkal van null meghívva.

ArgumentException

A megadott helyi név és névtér URI-ja nem egyezik meg az éppen beolvasott elemével.

Megjegyzések

Ez a metódus felolvassa a kezdőcímkét, az elem tartalmát, és áthelyezi az olvasót a záróelem címkéje mellett. Kibővíti az entitásokat, és figyelmen kívül hagyja a feldolgozási utasításokat és megjegyzéseket. Az elem csak egyszerű tartalmat tartalmazhat. Vagyis nem rendelkezhet gyermekelemekkel.

További információkért tekintse meg a referenciaoldal Megjegyzések szakaszát XmlReader és a W3C XML-séma 2. részét: Adattípusokra vonatkozó javaslatot.