XmlReader.ReadContentAsString Methode

Definitie

Naamruimte:

System.Xml

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Bron:

XmlReader.cs

Leest de tekstinhoud op de huidige positie als een String object.

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

Retouren

String

De tekstinhoud als een String object.

Uitzonderingen

InvalidCastException

De poging tot cast is ongeldig.

FormatException

De tekenreeksindeling is ongeldig.

InvalidOperationException

Er XmlReader is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Opmerkingen

Met deze methode worden tekst, witruimte, significante witruimte en CDATA-secties samengevoegd en worden opmerkingen of verwerkingsinstructies overgeslagen. Entiteitsverwijzingen worden automatisch omgezet.

Deze methode kan worden gebruikt om getypte waarden te converteren naar een tekenreeks of om de tekstinhoud te lezen tijdens het overslaan van opmerkingen en verwerkingsinstructies.

In de volgende tabel wordt beschreven hoe deze methode elk knooppunttype behandelt.

XmlNodeType	Retourwaarde	Gedrag van lezer
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Samengevoegde inhoud van tekst, CDATA, witruimte en significante witruimteknooppunten geconverteerd naar het aangevraagde type.	Hiermee gaat u naar de volgende tag voor het beginelement of het volgende eindelement. Entiteitsverwijzingen worden automatisch uitgebreid.
Attribute	Hetzelfde als het aanroepen XmlConvert.ToXxx van de kenmerkwaarde.	De lezer blijft op de huidige positie.
Comment ProcessingInstruction	Negeert de verwerkingsinstructie (PI) of opmerking en leest de samengevoegde tekstinhoud die volgt op de PI of opmerking.	Hiermee gaat u naar de volgende tag voor het beginelement of het volgende eindelement. Entiteitsverwijzingen worden automatisch uitgebreid.
EndElement	Een lege tekenreeks.	De lezer blijft op de huidige positie.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Er is een InvalidOperationException gegooid.	Niet gedefinieerd, hoewel de lezer doorgaans in de huidige positie blijft.

Zie de sectie Opmerkingen van de XmlReader referentiepagina en het W3C XML-schema deel 2: aanbeveling voor gegevenstypen voor meer informatie.

Zie voor de asynchrone versie van deze methode ReadContentAsStringAsync.