XmlReader.ReadElementContentAsLong 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 64bitové signed integer.

Přetížení

Name	Description
ReadElementContentAsLong()	Přečte aktuální prvek a vrátí obsah jako 64bitové signed integer.
ReadElementContentAsLong(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 64bitové celé číslo se signed.

ReadElementContentAsLong()

Zdroj:

XmlReader.cs

Přečte aktuální prvek a vrátí obsah jako 64bitové signed integer.

public:
 virtual long ReadElementContentAsLong();

public virtual long ReadElementContentAsLong();

abstract member ReadElementContentAsLong : unit -> int64
override this.ReadElementContentAsLong : unit -> int64

Public Overridable Function ReadElementContentAsLong () As Long

Návraty

Int64

Obsah elementu jako 64bitové celé číslo se signed.

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 64bitové celé číslo se signedem.

ArgumentNullException

Metoda je volána s null argumenty.

Příklady

Následující příklad používá metodu ReadElementContentAsLong ke čtení obsahu elementu longValue .

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("longValue");
     long number = reader.ReadElementContentAsLong();
     // Do some processing with the number object.
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("longValue")
  Dim number As Long = reader.ReadElementContentAsLong()
  ' Do some processing with the number object.
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.

Pokud je obsah zadán xsd:long, čtečka vrátí unboxed 64-bit signed integer. Pokud obsah není zadán xsd:long, čtenář se pokusí ho převést na 64bitové podepsané celé číslo podle pravidel definovaných schématem W3C XML část 2: Doporučení datových typů .

Další informace najdete v části Poznámky na XmlReader referenční stránce.

ReadElementContentAsLong(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 64bitové celé číslo se signed.

public:
 virtual long ReadElementContentAsLong(System::String ^ localName, System::String ^ namespaceURI);

public virtual long ReadElementContentAsLong(string localName, string namespaceURI);

abstract member ReadElementContentAsLong : string * string -> int64
override this.ReadElementContentAsLong : string * string -> int64

Public Overridable Function ReadElementContentAsLong (localName As String, namespaceURI As String) As Long

Parametry

localName

String

Místní název elementu.

namespaceURI

String

Identifikátor URI oboru názvů elementu.

Návraty

Int64

Obsah elementu jako 64bitové celé číslo se signed.

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 64bitové celé číslo se signedem.

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.

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.

Pokud je obsah zadán xsd:long, čtečka vrátí unboxed 64-bit signed integer. Pokud obsah není zadán xsd:long, čtenář se pokusí ho převést na 64bitové podepsané celé číslo podle pravidel definovaných schématem W3C XML část 2: Doporučení datových typů .

Další informace najdete v části Poznámky na XmlReader referenční stránce.