XmlReader.ReadElementContentAsString Methode

Definition

Liest das aktuelle Element und gibt den Inhalt als String-Objekt zurück.Reads the current element and returns the contents as a String object.

Ü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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

ReadElementContentAsString()

Liest das aktuelle Element und gibt den Inhalt als String-Objekt zurück.Reads the current element and returns the contents as a String object.

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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);
public virtual string ReadElementContentAsString (string localName, string namespaceURI);
abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string
Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Parameter

localName
String

Der lokale Name des Elements.The local name of the element.

namespaceURI
String

Der Namespace-URI des Elements.The namespace URI of the element.

Gibt zurück

String

Der Elementinhalt als String-Objekt.The element content as a String object.

Ausnahmen

Der XmlReader wird nicht auf einem Element positioniert.The XmlReader is not positioned on an element.

- oder --or-

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlReader method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Das aktuelle Element enthält untergeordnete Elemente.The current element contains child elements.

- oder --or- Der Elementinhalt kann nicht in ein String-Objekt konvertiert werden.The element content cannot be converted to a String object.

Die Methode wird mit null-Argumenten aufgerufen.The method is called with null arguments.

Der angegebene lokale Name und der Namespace-URI stimmen nicht mit dem Element überein, das gerade gelesen wird.The specified local name and namespace URI do not match that of the current element being read.

Beispiele

Im folgenden Beispiel wird das stringValue -Element gelesen und der Text Inhalt zurückgegeben (der Kommentar und die Verarbeitungsanweisung werden ignoriert).The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

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

In diesem Beispiel wird die Datei dataFile.xml als Eingabe verwendet.The example uses the dataFile.xml file as input.

<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, den Inhalt des Elements und verschiebt den Reader hinter das Endelementtag.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Es erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare.It expands entities and ignores processing instructions and comments. Das-Element kann nur einfachen Inhalt enthalten.The element can only contain simple content. Das heißt, es können keine untergeordneten Elemente vorhanden sein.That is, it cannot have child elements.

Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und in der Empfehlung " W3C XML Schema Part 2: Datatypes ".For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Gilt für:

ReadElementContentAsString()

Liest das aktuelle Element und gibt den Inhalt als String-Objekt zurück.Reads the current element and returns the contents as a String object.

public:
 virtual System::String ^ ReadElementContentAsString();
public virtual string ReadElementContentAsString ();
abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string
Public Overridable Function ReadElementContentAsString () As String

Gibt zurück

String

Der Elementinhalt als String-Objekt.The element content as a String object.

Ausnahmen

Der XmlReader wird nicht auf einem Element positioniert.The XmlReader is not positioned on an element.

- oder --or-

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlReader method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Das aktuelle Element enthält untergeordnete Elemente.The current element contains child elements.

- oder --or- Der Elementinhalt kann nicht in ein String-Objekt konvertiert werden.The element content cannot be converted to a String object.

Die Methode wird mit null-Argumenten aufgerufen.The method is called with null arguments.

Beispiele

Im folgenden Beispiel wird das stringValue -Element gelesen und der Text Inhalt zurückgegeben (der Kommentar und die Verarbeitungsanweisung werden ignoriert).The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

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

In diesem Beispiel wird die Datei dataFile.xml als Eingabe verwendet.The example uses the dataFile.xml file as input.

<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, den Inhalt des Elements und verschiebt den Reader hinter das Endelementtag.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Es erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare.It expands entities and ignores processing instructions and comments. Das-Element kann nur einfachen Inhalt enthalten.The element can only contain simple content. Das heißt, es können keine untergeordneten Elemente vorhanden sein.That is, it cannot have child elements.

Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und in der Empfehlung " W3C XML Schema Part 2: Datatypes ".For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Die asynchrone Version dieser Methode finden Sie unter ReadElementContentAsStringAsync .For the asynchronous version of this method, see ReadElementContentAsStringAsync.

Gilt für: