XmlReader.ReadElementContentAsLong Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Přečte aktuální prvek a vrátí obsah jako 64bitové podepsané celé číslo.

Přetížení

ReadElementContentAsLong()	Přečte aktuální prvek a vrátí obsah jako 64bitové podepsané celé číslo.
ReadElementContentAsLong(String, String)	Zkontroluje, že zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního prvku, pak přečte aktuální prvek a vrátí obsah jako 64bitové celé číslo se sign.

ReadElementContentAsLong()

Přečte aktuální prvek a vrátí obsah jako 64bitové podepsané celé číslo.

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 podepsaného.

Výjimky

InvalidOperationException

Není XmlReader umístěn na elementu.

-nebo-

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

XmlException

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

-nebo-

Obsah elementu nelze převést na 64bitové celé číslo se signtegerem.

ArgumentNullException

Metoda se volá 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. Rozbalí entity a ignoruje pokyny a komentáře ke zpracování. 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 signteger. Pokud obsah není zadán xsd:long, čtenář se pokusí ho převést na 64bitové podepsané celé číslo podle pravidel definovaných doporučením schématu W3C XML 2: Doporučení datových typů .

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

ReadElementContentAsLong(String, String)

Zkontroluje, že zadaný místní název a identifikátor URI oboru názvů odpovídá identifikátoru URI aktuálního prvku, pak přečte aktuální prvek a vrátí obsah jako 64bitové celé číslo se sign.

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

Výjimky

InvalidOperationException

Není XmlReader umístěn na elementu.

-nebo-

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

XmlException

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

-nebo-

Obsah elementu nelze převést na 64bitové celé číslo se signtegerem.

ArgumentNullException

Metoda se volá s null argumenty.

ArgumentException

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

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. Element 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í bezobslužné 64bitové celé číslo se znaménkem. 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 XML W3C část 2: Doporučení datových typů .

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