XmlReader.ReadElementContentAsObject Methode

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

Gibt zurück

Object

Ein geschachteltes CLR-Objekt (Common Language Runtime) des geeignetsten Typs. Die ValueType-Eigenschaft bestimmt den geeigneten CLR-Typ. Wenn der Inhalt als Listentyp typisiert ist, gibt diese Methode ein Array der geschachtelten Objekte des geeigneten Typs zurück.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die Methode verwendet, um den Inhalt des price Knotens zu lesen. Der Leser verwendet die Informationen im Schema, um den Inhalt dem richtigen Datentyp zuzuordnen.

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

Im Beispiel werden die folgenden beiden Dateien als Eingabe verwendet.

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>

Hinweise

Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser nach dem Endelementtag. Es erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfache Inhalte enthalten. Das heißt, es kann nicht über untergeordnete Elemente verfügen.

Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und des W3C-XML-Schemas Teil 2: Empfehlung für Datentypen .

Eine asynchrone Version dieser Methode finden Sie unter ReadElementContentAsObjectAsync.

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

Parameter

Gibt zurück

Object

Ein geschachteltes CLR-Objekt (Common Language Runtime) des geeignetsten Typs. Die ValueType-Eigenschaft bestimmt den geeigneten CLR-Typ. Wenn der Inhalt als Listentyp typisiert ist, gibt diese Methode ein Array der geschachtelten Objekte des geeigneten Typs zurück.

Ausnahmen

Hinweise

Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser nach dem Endelementtag. Es erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfache Inhalte enthalten. Das heißt, es kann nicht über untergeordnete Elemente verfügen.

Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und des W3C-XML-Schemas Teil 2: Empfehlung für Datentypen .