XmlReader.ReadContentAsObject 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 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

Válaszok

Object

A szöveges tartalom a legmegfelelőbb közös nyelvi futtatókörnyezeti (CLR) objektum.

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.

Ha a tartalom be van adva, az olvasó egy, a tulajdonság által ValueType megadott, a legmegfelelőbb típusú, dobozos CLR-t ad vissza. Ha a tartalom listatípus, az olvasó egy megfelelő típusú dobozos objektumtömböt ad vissza.

Note

Ha érvényesítési hiba történik a tartalom elemzése során, és az olvasó a XmlReader metódus által Create létrehozott objektum, az olvasó sztringként adja vissza a tartalmat. Más szóval érvényesítési hiba vagy figyelmeztetés esetén a tartalom beírás nélkülinek minősül.

Ha a tartalom nincs begépelve, az olvasó sztringként adja vissza a tartalmat.

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	Az elem értéke, ha az olvasó egy séma-érvényesítő olvasó (ValidationType a beállítás Schemaértéke); ellenkező esetben ü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 ReadContentAsObjectAsync: .