XmlReader.ReadElementContentAsString Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Liest das aktuelle Element und gibt den Inhalt als String-Objekt zurück.

Überlädt

ReadElementContentAsString(String, String)	Überprüft, ob der angegebene lokale Name und der angegebene Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als String-Objekt zurück.
ReadElementContentAsString()	Liest das aktuelle Element und gibt den Inhalt als String-Objekt zurück.

ReadElementContentAsString(String, String)

Quelle:

XmlReader.cs

Überprüft, ob der angegebene lokale Name und der angegebene Namespace-URI mit denen des aktuellen Elements übereinstimmen, liest dann das aktuelle Element und gibt den Inhalt als String-Objekt zurück.

C#

public virtual string ReadElementContentAsString(string localName, string namespaceURI);

Parameter

localName

String

Der lokale Name des Elements.

namespaceURI

String

Der Namespace-URI des Elements.

Gibt zurück

String

Der Elementinhalt als String-Objekt.

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 ein String-Objekt 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.

Beispiele

Im folgenden Beispiel wird das stringValue -Element gelesen und der Textinhalt zurückgegeben (der Kommentar und die Verarbeitungsanweisung werden ignoriert).

C#

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

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

XML

<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 .

ReadElementContentAsString()

Quelle:

XmlReader.cs

Liest das aktuelle Element und gibt den Inhalt als String-Objekt zurück.

C#

public virtual string ReadElementContentAsString();

Gibt zurück

String

Der Elementinhalt als String-Objekt.

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 ein String-Objekt konvertiert werden.

ArgumentNullException

Die Methode wird mit null-Argumenten aufgerufen.

Beispiele

Im folgenden Beispiel wird das stringValue -Element gelesen und der Textinhalt zurückgegeben (der Kommentar und die Verarbeitungsanweisung werden ignoriert).

C#

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

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

XML

<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 ReadElementContentAsStringAsync.