XmlReader.ReadContentAsString Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlReader.cs

Beolvassa a szöveges tartalmat az aktuális pozícióban objektumként String .

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

Válaszok

String

A szöveges tartalom objektumként String .

Kivételek

InvalidCastException

A megkísérelt szereposztás érvénytelen.

FormatException

A sztring formátuma érvénytelen.

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Megjegyzések

Ez a módszer összefűzi a szöveget, a szóközt, a jelentős üres területet és a CDATA-szakaszokat, és kihagyja a megjegyzéseket és a feldolgozási utasításokat. Az entitáshivatkozások automatikusan feloldódnak.

Ezzel a módszerrel a beírt értékeket sztringgé alakíthatja, vagy elolvashatja a szöveges tartalmat, miközben kihagyja a megjegyzéseket és a feldolgozási utasításokat.

Az alábbi táblázat azt ismerteti, hogy ez a módszer hogyan kezeli az egyes csomóponttípusokat.

XmlNodeType	Visszaadott érték	Olvasói viselkedés
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	A kért típusra konvertált szöveg, CDATA, fehér terület és jelentős térközcsomópontok összefűzött tartalma.	Ugrás a következő kezdőelemre vagy végelemcímkére. Az entitáshivatkozások automatikusan ki lesznek bontva.
Attribute	Ugyanaz, mint az attribútumérték meghívása XmlConvert.ToXxx .	Az olvasó a jelenlegi helyzetben marad.
Comment ProcessingInstruction	Figyelmen kívül hagyja a feldolgozási utasítást (PI) vagy megjegyzést, és felolvassa a pi vagy megjegyzést követő összefűzött szöveges tartalmat.	Ugrás a következő kezdőelemre vagy végelemcímkére. Az entitáshivatkozások automatikusan ki lesznek bontva.
EndElement	Üres sztring.	Az olvasó a jelenlegi helyzetben marad.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Egy InvalidOperationException van dobva.	Nincs definiálva, bár az olvasó általában a jelenlegi helyzetben marad.

További információkért tekintse meg a referenciaoldal Megjegyzések szakaszát XmlReader és a W3C XML-séma 2. részét: Adattípusokra vonatkozó javaslatot.

A metódus aszinkron verziójáról lásd ReadContentAsStringAsync: .