XmlReader.ReadContentAsObject Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Läser textinnehållet på den aktuella positionen som en 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
Returer
Textinnehållet som det lämpligaste CLR-objektet (Common Language Runtime).
Undantag
Försök till avgjutning är inte giltigt.
Strängformatet är ogiltigt.
En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".
Kommentarer
Den här metoden sammanfogar text, blanksteg, betydande blanksteg och CDATA-avsnitt och hoppar över eventuella kommentarer eller bearbetningsinstruktioner. Entitetsreferenser matchas automatiskt.
Om innehållet skrivs returnerar läsaren en rutad CLR av den lämpligaste typen, som anges av ValueType egenskapen. Om innehållet är en listtyp returnerar läsaren en matris med boxade objekt av lämplig typ.
Note
Om ett valideringsfel inträffar när innehållet parsas och läsaren är ett XmlReader objekt som skapats av Create metoden returnerar läsaren innehållet som en sträng. Med andra ord anses innehållet vara otypat när ett valideringsfel eller en varning inträffar.
Om innehållet inte skrivs returnerar läsaren innehållet som en sträng.
I följande tabell beskrivs hur den här metoden behandlar varje nodtyp.
| XmlNodeType | Returvärde | Läsarbeteende |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Sammanfogat innehåll i text, CDATA, tomt utrymme och betydande blankstegsnoder konverterade till den begärda typen. | Flyttar till taggen nästa startelement eller slutelement. Entitetsreferenser expanderas automatiskt. |
Attribute |
Samma sak som att anropa XmlConvert.ToXxx attributvärdet. |
Läsaren förblir i aktuell position |
CommentProcessingInstruction |
Ignorerar bearbetningsinstruktionen (PI) eller kommentaren och läser det sammanfogade textinnehållet som följer PI eller kommentaren. | Flyttar till taggen nästa startelement eller slutelement. Entitetsreferenser expanderas automatiskt. |
EndElement |
Värdet för elementet om läsaren är ett schema som validerar läsaren (ValidationType är inställt på Schema); annars en tom sträng. | Läsaren förblir i den aktuella positionen. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
En InvalidOperationException kastas. | Odefinierat, även om läsaren vanligtvis förblir i den aktuella positionen. |
Mer information finns i avsnittet Kommentarer på XmlReader referenssidan och W3C XML-schemadel 2: Rekommendationen Datatyper .
Den asynkrona versionen av den här metoden finns i ReadContentAsObjectAsync.