XmlReader.ReadElementContentAsLong Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Liest das aktuelle Element und gibt den Inhalt als 64-Bit-Ganzzahl zurück.

Überlädt

Name	Beschreibung
ReadElementContentAsLong()	Liest das aktuelle Element und gibt den Inhalt als 64-Bit-Ganzzahl zurück.
ReadElementContentAsLong(String, String)	Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als eine 64-Bit-ganzzahl mit Vorzeichen zurückgibt.

ReadElementContentAsLong()

Quelle:

XmlReader.cs

Liest das aktuelle Element und gibt den Inhalt als 64-Bit-Ganzzahl zurück.

public:
 virtual long ReadElementContentAsLong();

public virtual long ReadElementContentAsLong();

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

Public Overridable Function ReadElementContentAsLong () As Long

Gibt zurück

Int64

Der Elementinhalt als 64-Bit-Ganzzahl mit Vorzeichen.

Ausnahmen

InvalidOperationException

Die XmlReader Position wird nicht für ein Element positioniert.

- oder -

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

XmlException

Das aktuelle Element enthält untergeordnete Elemente.

- oder -

Der Elementinhalt kann nicht in eine 64-Bit-Ganzzahl konvertiert werden.

ArgumentNullException

Die Methode wird mit null Argumenten aufgerufen.

Beispiele

Im folgenden Beispiel wird die ReadElementContentAsLong Methode verwendet, um den Inhalt des longValue Elements zu lesen.

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

Im Beispiel wird die dataFile.xml Datei als Eingabe verwendet.

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

Hinweise

Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.

Wenn der Inhalt eingegeben xsd:longwird, gibt der Leser eine unboxierte 64-Bit-Ganzzahl mit Vorzeichen zurück. Wenn der Inhalt nicht eingegeben xsd:longwird, versucht der Leser, ihn in eine 64-Bit-ganzzahlige 64-Bit-Ganzzahl entsprechend den Regeln zu konvertieren, die durch die W3C XML-Schemateil 2: Empfehlung für Datentypen definiert sind.

Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

ReadElementContentAsLong(String, String)

Quelle:

XmlReader.cs

Überprüft, ob der angegebene lokale Name und der Namespace-URI mit dem des aktuellen Elements übereinstimmen, dann das aktuelle Element liest und den Inhalt als eine 64-Bit-ganzzahl mit Vorzeichen zurückgibt.

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

Parameter

localName

String

Der lokale Name des Elements.

namespaceURI

String

Der Namespace-URI des Elements.

Gibt zurück

Int64

Der Elementinhalt als 64-Bit-Ganzzahl mit Vorzeichen.

Ausnahmen

InvalidOperationException

Die XmlReader Position wird nicht für ein Element positioniert.

- oder -

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

XmlException

Das aktuelle Element enthält untergeordnete Elemente.

- oder -

Der Elementinhalt kann nicht in eine 64-Bit-Ganzzahl konvertiert werden.

ArgumentNullException

Die Methode wird mit null Argumenten aufgerufen.

ArgumentException

Der angegebene lokale Name und namespace-URI stimmen nicht mit dem des aktuellen Elements überein, das gelesen wird.

Hinweise

Diese Methode liest das Starttag, den Inhalt des Elements und verschiebt den Leser über das Endelementtag. Sie erweitert Entitäten und ignoriert Verarbeitungsanweisungen und Kommentare. Das Element kann nur einfachen Inhalt enthalten. Das heißt, es kann keine untergeordneten Elemente haben.

Wenn der Inhalt eingegeben xsd:longwird, gibt der Leser eine unboxierte 64-Bit-Ganzzahl mit Vorzeichen zurück. Wenn der Inhalt nicht eingegeben xsd:longwird, versucht der Leser, ihn in eine 64-Bit-ganzzahlige 64-Bit-Ganzzahl entsprechend den Regeln zu konvertieren, die durch die W3C XML-Schemateil 2: Empfehlung für Datentypen definiert sind.

Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.