XmlReader.ReadElementContentAsObject Methode

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly's:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Leest het huidige element en retourneert de inhoud als een Object.

Overloads

Name Description
ReadElementContentAsObject()

Leest het huidige element en retourneert de inhoud als een Object.
ReadElementContentAsObject(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud wordt geretourneerd als een Object.

ReadElementContentAsObject()

Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs

Leest het huidige element en retourneert de inhoud als een 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

Retouren

Object

Een common language runtime-object (CLR) van het meest geschikte type. De ValueType eigenschap bepaalt het juiste CLR-type. Als de inhoud wordt getypt als een lijsttype, retourneert deze methode een matrix met vakkenobjecten van het juiste type.

Uitzonderingen

InvalidOperationException

Het XmlReader element wordt niet op een element weergegeven.

– of –

Er XmlReader is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

XmlException

Het huidige element bevat onderliggende elementen.

– of –

De elementinhoud kan niet worden geconverteerd naar het aangevraagde type

ArgumentNullException

De methode wordt aangeroepen met null argumenten.

Voorbeelden

In het volgende voorbeeld wordt de methode gebruikt om de inhoud van het price knooppunt te lezen. De lezer gebruikt de informatie in het schema om de inhoud toe te wijzen aan het juiste gegevenstype.

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

In het voorbeeld worden de volgende twee bestanden als invoer gebruikt.

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>

Opmerkingen

Deze methode leest de starttag, de inhoud van het element en verplaatst de lezer voorbij de eindelementtag. Het breidt entiteiten uit en negeert verwerkingsinstructies en opmerkingen. Het element kan alleen eenvoudige inhoud bevatten. Dat wil gezegd, het mag geen onderliggende elementen hebben.

Zie de sectie Opmerkingen van de XmlReader referentiepagina en het W3C XML-schema deel 2: aanbeveling voor gegevenstypen voor meer informatie.

Zie voor de asynchrone versie van deze methode ReadElementContentAsObjectAsync.

Van toepassing op

ReadElementContentAsObject(String, String)

Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs
Bron:
XmlReader.cs

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud wordt geretourneerd als een 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

Parameters

localName
String

De lokale naam van het element.

namespaceURI
String

De naamruimte-URI van het element.

Retouren

Object

Een common language runtime-object (CLR) van het meest geschikte type. De ValueType eigenschap bepaalt het juiste CLR-type. Als de inhoud wordt getypt als een lijsttype, retourneert deze methode een matrix met vakkenobjecten van het juiste type.

Uitzonderingen

InvalidOperationException

Het XmlReader element wordt niet op een element weergegeven.

– of –

Er XmlReader is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

XmlException

Het huidige element bevat onderliggende elementen.

– of –

De elementinhoud kan niet worden geconverteerd naar het aangevraagde type.

ArgumentNullException

De methode wordt aangeroepen met null argumenten.

ArgumentException

De opgegeven lokale naam en naamruimte-URI komen niet overeen met die van het huidige element dat wordt gelezen.

Opmerkingen

Deze methode leest de starttag, de inhoud van het element en verplaatst de lezer voorbij de eindelementtag. Het breidt entiteiten uit en negeert verwerkingsinstructies en opmerkingen. Het element kan alleen eenvoudige inhoud bevatten. Dat wil gezegd, het mag geen onderliggende elementen hebben.

Zie de sectie Opmerkingen van de XmlReader referentiepagina en het W3C XML-schema deel 2: aanbeveling voor gegevenstypen voor meer informatie.

Van toepassing op