Sdílet prostřednictvím


XmlReader.ReadContentAsObject Metoda

Definice

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

public:
 virtual System::Object ^ ReadContentAsObject();
public virtual object ReadContentAsObject ();
abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj
Public Overridable Function ReadContentAsObject () As Object

Návraty

Object

Textový obsah jako nejvhodnější objekt CLR (Common Language Runtime).

Výjimky

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

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

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ží.

Pokud je obsah zadaný, čtečka vrátí pole CLR nejvhodnějšího typu určeného ValueType vlastností. Pokud je obsah typu seznamu, vrátí čtečka pole s boxovanými objekty příslušného typu.

Poznámka

Pokud dojde k chybě ověření při analýze obsahu a čtenář je XmlReader objekt vytvořený Create metodou, čtečka vrátí obsah jako řetězec. Jinými slovy, pokud dojde k chybě ověření nebo upozornění, je obsah považován za nezatypovaný.

Pokud obsah nezadáváte, čtečka vrátí obsah jako řetězec.

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ůstane 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 Hodnota elementu, pokud je čtenář schématem ověřování čtenář (ValidationType je nastaven na Schema); jinak 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 ReadContentAsObjectAsync.

Platí pro