XmlReader.ReadContentAsObject Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlReader.cs

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

InvalidCastException

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

FormatException

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

InvalidOperationException

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

Poznámky

Tato metoda zřetězí text, prázdné znaky, 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 zadán, čtečka vrátí pole CLR nejvhodnějšího typu určeného ValueType vlastností. Pokud je obsah typem seznamu, čtečka vrátí pole krabicových objektů příslušného typu.

Poznámka:

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

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	Návratová 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	Ignoruje instrukce 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 validující čtenář (ValidationType je nastaven na Schema); jinak prázdný řetězec.	Čtenář zůstane 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á na aktuální pozici.

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

Asynchronní verzi této metody naleznete v tématu ReadContentAsObjectAsync.