XmlReader.ReadElementString XmlReader.ReadElementString XmlReader.ReadElementString XmlReader.ReadElementString Method

Definition

Liest die einfachen Nur-Text-Elemente.Reads the simple text-only elements. Sie sollten stattdessen allerdings die ReadElementContentAsString-Methode verwenden, da sie eine einfachere Möglichkeit zum Verarbeiten dieses Vorgangs bietet.However, we recommend that you use the ReadElementContentAsString method instead, because it provides a more straightforward way to handle this operation.

Überlädt

ReadElementString() ReadElementString() ReadElementString() ReadElementString()

Liest ein Nur-Text-Element.Reads a text-only element. Sie sollten stattdessen allerdings die ReadElementContentAsString()-Methode verwenden, da sie eine einfachere Möglichkeit zum Verarbeiten dieses Vorgangs bietet.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

ReadElementString(String) ReadElementString(String) ReadElementString(String) ReadElementString(String)

Überprüft vor dem Lesen eines Nur-Text-Elements, ob die Name-Eigenschaft des gefundenen Elements mit der angegebenen Zeichenfolge übereinstimmt.Checks that the Name property of the element found matches the given string before reading a text-only element. Sie sollten stattdessen allerdings die ReadElementContentAsString()-Methode verwenden, da sie eine einfachere Möglichkeit zum Verarbeiten dieses Vorgangs bietet.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String)

Überprüft vor dem Lesen eines Nur-Text-Elements, ob die LocalName-Eigenschaft und die NamespaceURI-Eigenschaft des gefundenen Elements mit den angegebenen Zeichenfolgen übereinstimmen.Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. Sie sollten stattdessen allerdings die ReadElementContentAsString(String, String)-Methode verwenden, da sie eine einfachere Möglichkeit zum Verarbeiten dieses Vorgangs bietet.However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

Hinweise

Es wird empfohlen, dass Sie ReadElementContentAsString die-Methode verwenden, um ein Textelement zu lesen.We recommend that you use the ReadElementContentAsString method to read a text element.

ReadElementString() ReadElementString() ReadElementString() ReadElementString()

Liest ein Nur-Text-Element.Reads a text-only element. Sie sollten stattdessen allerdings die ReadElementContentAsString()-Methode verwenden, da sie eine einfachere Möglichkeit zum Verarbeiten dieses Vorgangs bietet.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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

Gibt zurück

Der Text in dem gelesenen Element.The text contained in the element that was read. Eine leere Zeichenfolge, wenn das Element leer ist.An empty string if the element is empty.

Ausnahmen

Der nächste Inhaltsknoten ist kein Starttag, oder das gefundene Element enthält keinen Wert für einfachen Text.The next content node is not a start tag; or the element found does not contain a simple text value.

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

Hinweise

Es wird empfohlen, dass Sie ReadElementContentAsString() die-Methode verwenden, um ein Textelement zu lesen.We recommend that you use the ReadElementContentAsString() method to read a text element.

ReadElementString(String) ReadElementString(String) ReadElementString(String) ReadElementString(String)

Überprüft vor dem Lesen eines Nur-Text-Elements, ob die Name-Eigenschaft des gefundenen Elements mit der angegebenen Zeichenfolge übereinstimmt.Checks that the Name property of the element found matches the given string before reading a text-only element. Sie sollten stattdessen allerdings die ReadElementContentAsString()-Methode verwenden, da sie eine einfachere Möglichkeit zum Verarbeiten dieses Vorgangs bietet.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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

Parameter

name
String String String String

Der zu überprüfende Name.The name to check.

Gibt zurück

Der Text in dem gelesenen Element.The text contained in the element that was read. Eine leere Zeichenfolge, wenn das Element leer ist.An empty string if the element is empty.

Ausnahmen

Wenn der nächste Inhaltsknoten kein Starttag ist, wenn der Element Name mit dem angegebenen Argument nicht übereinstimmt oder wenn das gefundene Element keinen Wert für einfachen Text enthält.If the next content node is not a start tag; if the element Name does not match the given argument; or if the element found does not contain a simple text value.

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

Hinweise

Es wird empfohlen, dass Sie ReadElementContentAsString() die-Methode verwenden, um ein Textelement zu lesen.We recommend that you use the ReadElementContentAsString() method to read a text element.

ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String)

Überprüft vor dem Lesen eines Nur-Text-Elements, ob die LocalName-Eigenschaft und die NamespaceURI-Eigenschaft des gefundenen Elements mit den angegebenen Zeichenfolgen übereinstimmen.Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. Sie sollten stattdessen allerdings die ReadElementContentAsString(String, String)-Methode verwenden, da sie eine einfachere Möglichkeit zum Verarbeiten dieses Vorgangs bietet.However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

public:
 virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);
public virtual string ReadElementString (string localname, string ns);
abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> string
Public Overridable Function ReadElementString (localname As String, ns As String) As String

Parameter

localname
String String String String

Der zu überprüfende lokale Name.The local name to check.

ns
String String String String

Der zu überprüfende Namespace-URI.The namespace URI to check.

Gibt zurück

Der Text in dem gelesenen Element.The text contained in the element that was read. Eine leere Zeichenfolge, wenn das Element leer ist.An empty string if the element is empty.

Ausnahmen

Wenn der nächste Inhaltsknoten kein Starttag ist, wenn der LocalName oder NamespaceURI des Elements nicht mit den angegebenen Argumenten übereinstimmen oder wenn das gefundene Element keinen Wert für einfachen Text enthält.If the next content node is not a start tag; if the element LocalName or NamespaceURI do not match the given arguments; or if the element found does not contain a simple text value.

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

Hinweise

Es wird empfohlen, dass Sie ReadElementContentAsString(String, String) die-Methode verwenden, um ein Textelement zu lesen.We recommend that you use the ReadElementContentAsString(String, String) method to read a text element.

Gilt für: