XmlReader.ReadElementContentAsObject Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Liest das aktuelle Element und gibt den Inhalt als ein Object.

Überlädt

Name	Beschreibung
ReadElementContentAsObject()	Liest das aktuelle Element und gibt den Inhalt als ein Object.
ReadElementContentAsObject(String, String)	Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als ein Object.

ReadElementContentAsObject()

Quelle:

XmlReader.cs

Liest das aktuelle Element und gibt den Inhalt als ein 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

Gibt zurück

Object

Ein boxed Common Language Runtime (CLR)-Objekt des am besten geeigneten Typs. Die ValueType Eigenschaft bestimmt den entsprechenden CLR-Typ. Wenn der Inhalt als Listentyp eingegeben wird, gibt diese Methode ein Array von Boxobjekten des entsprechenden Typs zurück.

Ausnahmen

InvalidOperationException

Die XmlReader Position wird nicht für ein Element positioniert.

- oder -

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

XmlException

Das aktuelle Element enthält untergeordnete Elemente.

- oder -

Der Elementinhalt kann nicht in den angeforderten Typ konvertiert werden.

ArgumentNullException

Die Methode wird mit null Argumenten aufgerufen.

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 über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.

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

Die asynchrone Version dieser Methode finden Sie unter ReadElementContentAsObjectAsync.

ReadElementContentAsObject(String, String)

Quelle:

XmlReader.cs

Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als ein 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

Parameter

localName

String

Der lokale Name des Elements.

namespaceURI

String

Der Namespace-URI des Elements.

Gibt zurück

Object

Ein boxed Common Language Runtime (CLR)-Objekt des am besten geeigneten Typs. Die ValueType Eigenschaft bestimmt den entsprechenden CLR-Typ. Wenn der Inhalt als Listentyp eingegeben wird, gibt diese Methode ein Array von Boxobjekten des entsprechenden Typs zurück.

Ausnahmen

InvalidOperationException

Die XmlReader Position wird nicht für ein Element positioniert.

- oder -

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

XmlException

Das aktuelle Element enthält untergeordnete Elemente.

- oder -

Der Elementinhalt kann nicht in den angeforderten Typ konvertiert werden.

ArgumentNullException

Die Methode wird mit null Argumenten aufgerufen.

ArgumentException

Der angegebene lokale Name und namespace-URI stimmen nicht mit dem des aktuellen Elements überein, das gelesen wird.

Hinweise

Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.

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