XmlReader.ReadElementContentAs Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Liest das aktuelle Element und gibt den Inhalt als Objekt vom angegebenen Typ zurück.

Überlädt

ReadElementContentAs(Type, IXmlNamespaceResolver)	Liest den Elementinhalt als angeforderten Typ.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Überprüft, ob der angegebene lokale Name und der angegebene Namespace-URI mit denen des aktuellen Elements übereinstimmen, und liest dann den Elementinhalt als angeforderten Typ.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Quelle:

XmlReader.cs

Liest den Elementinhalt als angeforderten Typ.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parameter

returnType

Type

Der Typ des zurückzugebenden Werts.

Hinweis Seit der Veröffentlichung von .NET Framework 3.5 kann der Wert des returnType-Parameters nun auch auf den DateTimeOffset-Typ festgelegt werden.

namespaceResolver

IXmlNamespaceResolver

Ein IXmlNamespaceResolver-Objekt, das für die Auflösung von Präfixen von Namespaces verwendet wird, die im Zusammenhang mit der Typkonvertierung stehen.

Gibt zurück

Object

Der in das angeforderte typisierte Objekt konvertierte Elementinhalt.

Ausnahmen

InvalidOperationException

Der XmlReader wird nicht auf einem Element positioniert.

- oder -

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang 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.

OverflowException

Lesen von Decimal.MaxValue.

Beispiele

Im folgenden Beispiel wird die ReadElementContentAs -Methode verwendet, um den Inhalt des date Knotens zu lesen.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

In diesem Beispiel wird die Datei dataFile.xml als Eingabe verwendet.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Hinweise

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

Weitere Informationen finden Sie im Abschnitt Hinweise der XmlReader Referenzseite und in der Empfehlung W3C XML Schema Part 2: Datatypes .

Die asynchrone Version dieser Methode finden Sie unter ReadElementContentAsAsync.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Quelle:

XmlReader.cs

Überprüft, ob der angegebene lokale Name und der angegebene Namespace-URI mit denen des aktuellen Elements übereinstimmen, und liest dann den Elementinhalt als angeforderten Typ.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Parameter

returnType

Type

Der Typ des zurückzugebenden Werts.

Hinweis Seit der Veröffentlichung von .NET Framework 3.5 kann der Wert des returnType-Parameters nun auch auf den DateTimeOffset-Typ festgelegt werden.

namespaceResolver

IXmlNamespaceResolver

Ein IXmlNamespaceResolver-Objekt, das für die Auflösung von Präfixen von Namespaces verwendet wird, die im Zusammenhang mit der Typkonvertierung stehen.

localName

String

Der lokale Name des Elements.

namespaceURI

String

Der Namespace-URI des Elements.

Gibt zurück

Object

Der in das angeforderte typisierte Objekt konvertierte Elementinhalt.

Ausnahmen

InvalidOperationException

Der XmlReader wird nicht auf einem Element positioniert.

- oder -

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang 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 der Namespace-URI stimmen nicht mit dem Element überein, das gerade gelesen wird.

OverflowException

Lesen von Decimal.MaxValue.

Hinweise

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

Weitere Informationen finden Sie im Abschnitt Hinweise der XmlReader Referenzseite und in der Empfehlung W3C XML Schema Part 2: Datatypes .