XmlReader.ReadElementString Methode

Definition

Liest die einfachen Nur-Text-Elemente vor. Es wird jedoch empfohlen, stattdessen die ReadElementContentAsString Methode zu verwenden, da sie eine einfachere Möglichkeit zum Behandeln dieses Vorgangs bietet.

Überlädt

Name Beschreibung
ReadElementString()

Liest ein textgeschütztes Element. Es wird jedoch empfohlen, stattdessen die ReadElementContentAsString() Methode zu verwenden, da sie eine einfachere Möglichkeit zum Behandeln dieses Vorgangs bietet.

ReadElementString(String)

Überprüft, ob die Gefundene Name Eigenschaft des Elements mit der angegebenen Zeichenfolge übereinstimmt, bevor ein textgeschütztes Element gelesen wird. Es wird jedoch empfohlen, stattdessen die ReadElementContentAsString() Methode zu verwenden, da sie eine einfachere Möglichkeit zum Behandeln dieses Vorgangs bietet.

ReadElementString(String, String)

Überprüft, ob die gefundenen Eigenschaften und LocalName Die NamespaceURI Eigenschaften des Elements den angegebenen Zeichenfolgen entsprechen, bevor ein nur textgeschütztes Element gelesen wird. Es wird jedoch empfohlen, stattdessen die ReadElementContentAsString(String, String) Methode zu verwenden, da sie eine einfachere Möglichkeit zum Behandeln dieses Vorgangs bietet.

Hinweise

Es wird empfohlen, die Methode zum Lesen eines Textelements zu verwenden ReadElementContentAsString .

ReadElementString()

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Liest ein textgeschütztes Element. Es wird jedoch empfohlen, stattdessen die ReadElementContentAsString() Methode zu verwenden, da sie eine einfachere Möglichkeit zum Behandeln dieses Vorgangs bietet.

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, der im gelesenen Element enthalten ist. Eine leere Zeichenfolge, wenn das Element leer ist.

Ausnahmen

Der nächste Inhaltsknoten ist kein Starttag; oder das gefundene Element enthält keinen einfachen Textwert.

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.

Hinweise

Es wird empfohlen, die Methode zum Lesen eines Textelements zu verwenden ReadElementContentAsString() .

Gilt für:

ReadElementString(String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Überprüft, ob die Gefundene Name Eigenschaft des Elements mit der angegebenen Zeichenfolge übereinstimmt, bevor ein textgeschütztes Element gelesen wird. Es wird jedoch empfohlen, stattdessen die ReadElementContentAsString() Methode zu verwenden, da sie eine einfachere Möglichkeit zum Behandeln dieses Vorgangs bietet.

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

Der zu überprüfende Name.

Gibt zurück

Der Text, der im gelesenen Element enthalten ist. Eine leere Zeichenfolge, wenn das Element leer ist.

Ausnahmen

Wenn der nächste Inhaltsknoten kein Starttag ist; wenn das Element Name nicht mit dem angegebenen Argument übereinstimmt, oder wenn das gefundene Element keinen einfachen Textwert enthält.

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.

Hinweise

Es wird empfohlen, die Methode zum Lesen eines Textelements zu verwenden ReadElementContentAsString() .

Gilt für:

ReadElementString(String, String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Überprüft, ob die gefundenen Eigenschaften und LocalName Die NamespaceURI Eigenschaften des Elements den angegebenen Zeichenfolgen entsprechen, bevor ein nur textgeschütztes Element gelesen wird. Es wird jedoch empfohlen, stattdessen die ReadElementContentAsString(String, String) Methode zu verwenden, da sie eine einfachere Möglichkeit zum Behandeln dieses Vorgangs bietet.

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

Der zu überprüfende lokale Name.

ns
String

Der zu überprüfende Namespace-URI.

Gibt zurück

Der Text, der im gelesenen Element enthalten ist. Eine leere Zeichenfolge, wenn das Element leer ist.

Ausnahmen

Wenn der nächste Inhaltsknoten kein Starttag ist; wenn das Element LocalName nicht NamespaceURI mit den angegebenen Argumenten übereinstimmt oder wenn das gefundene Element keinen einfachen Textwert enthält.

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.

Hinweise

Es wird empfohlen, die Methode zum Lesen eines Textelements zu verwenden ReadElementContentAsString(String, String) .

Gilt für: