XmlReader.ReadElementContentAsString Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest das aktuelle Element und gibt den Inhalt als String Objekt zurück.
Überlädt
| Name | Beschreibung |
|---|---|
| ReadElementContentAsString(String, String) |
Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als String Objekt zurückgibt. |
| ReadElementContentAsString() |
Liest das aktuelle Element und gibt den Inhalt als String Objekt zurück. |
ReadElementContentAsString(String, String)
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als String Objekt zurückgibt.
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 -> stringPublic Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As StringParameter
- localName
- String
Der lokale Name des Elements.
- namespaceURI
- String
Der Namespace-URI des Elements.
Gibt zurück
Der Elementinhalt als String Objekt.
Ausnahmen
Die XmlReader Position wird nicht für ein Element positioniert.
- oder -
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.
Das aktuelle Element enthält untergeordnete Elemente.
- oder -
Der Elementinhalt kann nicht in ein String Objekt konvertiert werden.
Die Methode wird mit null Argumenten aufgerufen.
Der angegebene lokale Name und namespace-URI stimmen nicht mit dem des aktuellen Elements überein, das gelesen wird.
Beispiele
Im folgenden Beispiel wird das stringValue Element gelesen und der Textinhalt zurückgegeben (die Kommentar- und Verarbeitungsanweisung wird ignoriert).
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
Im Beispiel wird die dataFile.xml Datei 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, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.
Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und im W3C-XML-Schemateil 2: Empfehlung für Datentypen .
Gilt für:
ReadElementContentAsString()
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Liest das aktuelle Element und gibt den Inhalt als String Objekt zurück.
public:
virtual System::String ^ ReadElementContentAsString();public virtual string ReadElementContentAsString();abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> stringPublic Overridable Function ReadElementContentAsString () As StringGibt zurück
Der Elementinhalt als String Objekt.
Ausnahmen
Die XmlReader Position wird nicht für ein Element positioniert.
- oder -
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.
Das aktuelle Element enthält untergeordnete Elemente.
- oder -
Der Elementinhalt kann nicht in ein String Objekt konvertiert werden.
Die Methode wird mit null Argumenten aufgerufen.
Beispiele
Im folgenden Beispiel wird das stringValue Element gelesen und der Textinhalt zurückgegeben (die Kommentar- und Verarbeitungsanweisung wird ignoriert).
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
Im Beispiel wird die dataFile.xml Datei 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, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.
Weitere Informationen finden Sie im Abschnitt "Hinweise" der XmlReader Referenzseite und im W3C-XML-Schemateil 2: Empfehlung für Datentypen .
Die asynchrone Version dieser Methode finden Sie unter ReadElementContentAsStringAsync.
