XmlReader.ReadContentAsString Metod

Definition

Namnområde:

System.Xml

Sammansättningar:

netstandard.dll, System.Xml.ReaderWriter.dll

Källa:

XmlReader.cs

Läser textinnehållet på den aktuella positionen som ett String objekt.

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

Returer

String

Textinnehållet som ett String objekt.

Undantag

InvalidCastException

Försök till avgjutning är inte giltigt.

FormatException

Strängformatet är ogiltigt.

InvalidOperationException

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.

Den här metoden kan användas för att konvertera inskrivna värden till en sträng eller för att läsa textinnehållet när du hoppar över kommentarer och bearbetningsinstruktioner.

I följande tabell beskrivs hur den här metoden behandlar varje nodtyp.

XmlNodeType	Returvärde	Läsarbeteende
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	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 den aktuella positionen.
Comment ProcessingInstruction	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	En tom sträng.	Läsaren förblir i den aktuella positionen.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	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 ReadContentAsStringAsync.