Freigeben über


XmlReader.ReadContentAsLong Methode

Definition

Liest den Textinhalt an der aktuellen Position als eine 64-Bit-ganzzahlige Vorzeichen vor.

public:
 virtual long ReadContentAsLong();
public virtual long ReadContentAsLong();
abstract member ReadContentAsLong : unit -> int64
override this.ReadContentAsLong : unit -> int64
Public Overridable Function ReadContentAsLong () As Long

Gibt zurück

Der Textinhalt als eine 64-Bit-Ganzzahl mit Vorzeichen.

Ausnahmen

Die versuchte Umwandlung ist ungültig.

Das Zeichenfolgenformat ist ungültig.

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.

Hinweise

Diese Methode verkettet Text, Leerzeichen, signifikanten Leerraum und CDATA-Abschnitte und überspringt Kommentare oder Verarbeitungsanweisungen. Entitätsverweise werden automatisch aufgelöst.

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.

In der folgenden Tabelle werden die einzelnen Knotentypen behandelt.

Xmlnodetype Zurückgegebener Wert Leseverhalten
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Verketteter Inhalt von Text, CDATA, Leerzeichen und signifikanten Leerraumknoten, die in den angeforderten Typ konvertiert wurden. Wechselt zum nächsten Startelement- oder Endelementtag. Entitätsverweise werden automatisch erweitert.
Attribute Identisch mit XmlConvert.ToXxx attributwert. Der Leser verbleibt an der aktuellen Position.
Comment

ProcessingInstruction
Ignoriert die Verarbeitungsanweisung (PI) oder den Kommentar und liest den verketteten Textinhalt, der auf die PI oder den Kommentar folgt. Wechselt zum nächsten Startelement- oder Endelementtag. Entitätsverweise werden automatisch erweitert.
EndElement Eine leere Zeichenfolge. Der Leser verbleibt an der aktuellen Position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Es InvalidOperationException wird eingeworfen. Undefiniert, obwohl der Leser in der Regel an der aktuellen Position bleibt.

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

Gilt für: