XmlReader.ReadElementContentAsString Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Přečte aktuální prvek a vrátí obsah jako String objekt.

Přetížení

Name	Description
ReadElementContentAsString(String, String)	Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako String objekt.
ReadElementContentAsString()	Přečte aktuální prvek a vrátí obsah jako String objekt.

ReadElementContentAsString(String, String)

Zdroj:

XmlReader.cs

Zkontroluje, zda zadaný místní název a identifikátor URI oboru názvů odpovídá aktuálnímu prvku, pak přečte aktuální prvek a vrátí obsah jako String objekt.

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

Parametry

localName

String

Místní název elementu.

namespaceURI

String

Identifikátor URI oboru názvů elementu.

Návraty

String

Obsah elementu jako objekt.String

Výjimky

InvalidOperationException

Není XmlReader umístěn na prvku.

nebo

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

XmlException

Aktuální prvek obsahuje podřízené elementy.

nebo

Obsah elementu nelze převést na String objekt.

ArgumentNullException

Metoda je volána s null argumenty.

ArgumentException

Zadaný místní název a identifikátor URI oboru názvů se neshodují s aktuálním načteným elementem.

Příklady

Následující příklad přečte stringValue prvek a vrátí textový obsah (ignorování komentáře a zpracování instrukce).

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

Příklad používá dataFile.xml soubor jako vstup.

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

Poznámky

Tato metoda přečte počáteční značku, obsah elementu a přesune čtenáře za značku koncového prvku. Rozšiřuje entity a ignoruje pokyny ke zpracování a komentáře. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

Další informace naleznete v části XmlReader Poznámky na referenční stránce a schématu W3C XML část 2: Doporučení datových typů .

ReadElementContentAsString()

Zdroj:

XmlReader.cs

Přečte aktuální prvek a vrátí obsah jako String objekt.

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

Návraty

String

Obsah elementu jako objekt.String

Výjimky

InvalidOperationException

Není XmlReader umístěn na prvku.

nebo

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

XmlException

Aktuální prvek obsahuje podřízené elementy.

nebo

Obsah elementu nelze převést na String objekt.

ArgumentNullException

Metoda je volána s null argumenty.

Příklady

Následující příklad přečte stringValue prvek a vrátí textový obsah (ignorování komentáře a zpracování instrukce).

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

Příklad používá dataFile.xml soubor jako vstup.

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

Poznámky

Tato metoda přečte počáteční značku, obsah elementu a přesune čtenáře za značku koncového prvku. Rozšiřuje entity a ignoruje pokyny ke zpracování a komentáře. Prvek může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

Další informace naleznete v části XmlReader Poznámky na referenční stránce a schématu W3C XML část 2: Doporučení datových typů .

Asynchronní verzi této metody naleznete v tématu ReadElementContentAsStringAsync.