XmlReader.ReadElementContentAsString Methode

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll

Leest het huidige element en retourneert de inhoud als een String object.

Overloads

Name Description
ReadElementContentAsString(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud als een String object wordt geretourneerd.
ReadElementContentAsString()

Leest het huidige element en retourneert de inhoud als een String object.

ReadElementContentAsString(String, String)

Controleert of de opgegeven lokale naam- en naamruimte-URI overeenkomt met die van het huidige element, waarna het huidige element wordt gelezen en de inhoud als een String object wordt geretourneerd.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);
public virtual string ReadElementContentAsString(string localName, string namespaceURI);
abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string
Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Parameters

localName
String

De lokale naam van het element.

namespaceURI
String

De naamruimte-URI van het element.

Retouren

String

De elementinhoud als een String object.

Uitzonderingen

InvalidOperationException

Het XmlReader element wordt niet op een element weergegeven.

– of –

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'.

XmlException

Het huidige element bevat onderliggende elementen.

– of –

De elementinhoud kan niet worden geconverteerd naar een String object.

ArgumentNullException

De methode wordt aangeroepen met null argumenten.

ArgumentException

De opgegeven lokale naam en naamruimte-URI komen niet overeen met die van het huidige element dat wordt gelezen.

Voorbeelden

In het volgende voorbeeld wordt het stringValue element gelezen en wordt de tekstinhoud geretourneerd (waarbij de opmerking en de verwerkingsinstructie worden genegeerd).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

In het voorbeeld wordt het dataFile.xml bestand als invoer gebruikt.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Opmerkingen

Deze methode leest de starttag, de inhoud van het element en verplaatst de lezer voorbij de eindelementtag. Het breidt entiteiten uit en negeert verwerkingsinstructies en opmerkingen. Het element kan alleen eenvoudige inhoud bevatten. Dat wil gezegd, het mag geen onderliggende elementen hebben.

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

Van toepassing op

ReadElementContentAsString()

Leest het huidige element en retourneert de inhoud als een String object.

public:
 virtual System::String ^ ReadElementContentAsString();
public virtual string ReadElementContentAsString();
abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string
Public Overridable Function ReadElementContentAsString () As String

Retouren

String

De elementinhoud als een String object.

Uitzonderingen

InvalidOperationException

Het XmlReader element wordt niet op een element weergegeven.

– of –

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'.

XmlException

Het huidige element bevat onderliggende elementen.

– of –

De elementinhoud kan niet worden geconverteerd naar een String object.

ArgumentNullException

De methode wordt aangeroepen met null argumenten.

Voorbeelden

In het volgende voorbeeld wordt het stringValue element gelezen en wordt de tekstinhoud geretourneerd (waarbij de opmerking en de verwerkingsinstructie worden genegeerd).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

In het voorbeeld wordt het dataFile.xml bestand als invoer gebruikt.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Opmerkingen

Deze methode leest de starttag, de inhoud van het element en verplaatst de lezer voorbij de eindelementtag. Het breidt entiteiten uit en negeert verwerkingsinstructies en opmerkingen. Het element kan alleen eenvoudige inhoud bevatten. Dat wil gezegd, het mag geen onderliggende elementen hebben.

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 ReadElementContentAsStringAsync.

Van toepassing op