XmlReader.ReadContentAsLong Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest den Textinhalt an der aktuellen Position als 64-Bit-Ganzzahl mit Vorzeichen.
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 64-Bit-Ganzzahl mit Vorzeichen.
Ausnahmen
Die versuchte Typumwandlung ist ungültig.
Das Zeichenfolgenformat ist nicht gültig.
Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.
Hinweise
Diese Methode verkettet Text, Leerraum, signifikante Leerzeichen und CDATA-Abschnitte und überspringt Kommentare oder Verarbeitungsanweisungen. Entitätsverweise werden automatisch aufgelöst.
Wenn der Inhalt eingegeben xsd:long
ist, gibt der Leser eine unverpackte 64-Bit-Ganzzahl mit Vorzeichen zurück. Wenn der Inhalt nicht eingegeben xsd:long
ist, versucht der Leser, ihn gemäß den Regeln, die durch die Empfehlung W3C XML Schema Part 2: Datatypes definiert werden, in eine 64-Bit-Ganzzahl mit Vorzeichen zu konvertieren.
In der folgenden Tabelle wird beschrieben, wie diese Methode jeden Knotentyp behandelt.
XmlNodeType | Rückgabewert | Verhalten des Readers |
---|---|---|
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity |
Verketteter Inhalt von Text, CDATA, Leerraum und signifikantem Leerraumknoten, konvertiert in den angeforderten Typ. | Wird zum nächsten Anfangselement- oder Endelementtag verschoben. Entitätsverweise werden automatisch erweitert. |
Attribute |
Identisch mit XmlConvert.ToXxx dem Wert des Attributs. |
Der Leser verbleibt in der aktuellen Position |
Comment ProcessingInstruction |
Ignoriert die Verarbeitungsanweisung oder den Kommentar und liest den verketteten Textinhalt, der auf die Verarbeitungsanweisung oder den Kommentar folgt. | Wird zum nächsten Anfangselement- oder Endelementtag verschoben. Entitätsverweise werden automatisch erweitert. |
EndElement |
Eine leere Zeichenfolge. | Der Reader behält die aktuelle Position bei. |
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment |
Es wird eine InvalidOperationException ausgelöst. | Nicht definiert, der Reader behält jedoch i. d. R. die aktuelle Position bei. |
Weitere Informationen finden Sie im Abschnitt Hinweise unter der XmlReader Referenzseite.