XmlReader.ReadContentAsString Metoda

  • Reference

Definice

Obor názvů:
System.Xml
Sestavení:
System.Xml.ReaderWriter.dll
Sestavení:
System.Xml.dll
Sestavení:
netstandard.dll

Přečte textový obsah na aktuální pozici jako String objekt.

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

Návraty

String

Textový obsah jako String objekt.

Výjimky

InvalidCastException

Pokus o přetypování není platný.

FormatException

Formát řetězce není platný.

InvalidOperationException

XmlReader Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Poznámky

Tato metoda zřetězí text, prázdné místo, významné prázdné znaky a oddíly CDATA a přeskočí všechny komentáře nebo pokyny ke zpracování. Odkazy na entity se automaticky přeloží.

Tuto metodu lze použít k převodu zadaných hodnot na řetězec nebo ke čtení textového obsahu při přeskočení komentářů a pokynů ke zpracování.

Následující tabulka popisuje, jak tato metoda zpracovává jednotlivé typy uzlů.

Xmlnodetype Vrácená hodnota Chování čtenáře
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity		 Zřetězený obsah textu, CDATA, prázdného místa a významných uzlů prázdných znaků převedených na požadovaný typ. Přesune se na další počáteční prvek nebo značku koncového prvku. Odkazy na entity se automaticky rozbalí.
Attribute Stejné jako volání XmlConvert.ToXxx hodnoty atributu. Čtenář zůstává v aktuální pozici.
Comment

ProcessingInstruction		 Přeskočí instrukce pro zpracování (PI) nebo komentář a přečte zřetězený textový obsah, který následuje za PI nebo komentářem. Přesune se na další počáteční prvek nebo značku koncového prvku. Odkazy na entity se automaticky rozbalí.
EndElement Prázdný řetězec. Čtenář zůstává v aktuální pozici.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment		 Je InvalidOperationException vyvolán. Nedefinováno, i když čtenář obvykle zůstává v aktuální pozici.

Další informace najdete v části XmlReader Poznámky referenční stránky a doporučení schématu XML W3C 2: Doporučení datových typů .

Asynchronní verze této metody naleznete v tématu ReadContentAsStringAsync.

Platí pro