Sdílet prostřednictvím


XmlReader.ReadElementContentAsString Metoda

Definice

Načte aktuální prvek a vrátí obsah jako String objekt.

Přetížení

ReadElementContentAsString(String, String)

Zkontroluje, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak načte aktuální element a vrátí obsah jako String objekt.

ReadElementContentAsString()

Načte aktuální prvek a vrátí obsah jako String objekt.

ReadElementContentAsString(String, String)

Zdroj:
XmlReader.cs
Zdroj:
XmlReader.cs
Zdroj:
XmlReader.cs

Zkontroluje, jestli zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního elementu, a pak načte aktuální element 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

Obsah prvku jako String objekt.

Výjimky

Objekt XmlReader není 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 se zprávou "Asynchronní operace již probíhá.".

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

-nebo-

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

Metoda je volána s null argumenty.

Zadaný místní název a identifikátor URI oboru názvů se neshodují s identifikátorem URI aktuálního prvku, který se čte.

Příklady

Následující příklad přečte stringValue element a vrátí textový obsah (bez ohledu na komentář a instrukce pro zpracování).

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

V příkladu se dataFile.xml jako vstup použije soubor .

<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. Rozbaluje entity a ignoruje pokyny ke zpracování a komentáře. Element může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

Další informace naleznete v části Poznámky na XmlReader referenční stránce a W3C XML Schema Part 2: Datatypes doporučení.

Platí pro

ReadElementContentAsString()

Zdroj:
XmlReader.cs
Zdroj:
XmlReader.cs
Zdroj:
XmlReader.cs

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

Obsah prvku jako String objekt.

Výjimky

Objekt XmlReader není 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 se zprávou "Asynchronní operace již probíhá.".

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

-nebo-

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

Metoda je volána s null argumenty.

Příklady

Následující příklad přečte stringValue element a vrátí textový obsah (bez ohledu na komentář a instrukce pro zpracování).

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

V příkladu se dataFile.xml jako vstup použije soubor .

<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. Rozbaluje entity a ignoruje pokyny ke zpracování a komentáře. Element může obsahovat pouze jednoduchý obsah. To znamená, že nemůže mít podřízené prvky.

Další informace naleznete v části Poznámky na XmlReader referenční stránce a W3C XML Schema Part 2: Datatypes doporučení.

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

Platí pro