XmlReader.ReadContentAsLong Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Odczytuje zawartość tekstową na bieżącej pozycji jako 64-bitową liczbę całkowitą ze znakiem.

public:
 virtual long ReadContentAsLong();

public virtual long ReadContentAsLong ();

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

Public Overridable Function ReadContentAsLong () As Long

Zwraca

Int64

Zawartość tekstowa jako 64-bitowa liczba całkowita z podpisem.

Wyjątki

InvalidCastException

Próba rzutowania jest nieprawidłowa.

FormatException

Format ciągu jest nieprawidłowy.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Ta metoda łączy tekst, biały odstęp, znaczne odstępy i sekcje CDATA oraz pomija wszelkie komentarze lub instrukcje przetwarzania. Odwołania do jednostek są automatycznie rozwiązywane.

Jeśli zawartość jest typowana xsd:long, czytnik zwraca bez skrzynki odbiorczej 64-bitową liczbę całkowitą podpisaną. Jeśli zawartość nie jest typowana xsd:long, czytelnik próbuje przekonwertować ją na 64-bitową liczbę całkowitą podpisaną zgodnie z regułami zdefiniowanymi przez rekomendację W3C XML Schema Part 2: Datatypes .

W poniższej tabeli opisano tę metodę traktują każdy typ węzła.

XmlNodeType	Wartość zwracana	Zachowanie czytelnika
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Połączona zawartość tekstu, CDATA, odstępu i znaczących węzłów odstępów przekonwertowanych na żądany typ.	Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
Attribute	Tak samo jak XmlConvert.ToXxx w przypadku wartości atrybutu.	Czytelnik pozostaje w bieżącej pozycji
Comment ProcessingInstruction	Ignoruje instrukcję przetwarzania (PI) lub komentarz i odczytuje połączoną zawartość tekst, która jest zgodna z danymi pi lub komentarzem.	Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
EndElement	Pusty ciąg.	Czytelnik pozostaje w bieżącej pozycji.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Jest InvalidOperationException zgłaszany.	Niezdefiniowane, chociaż zazwyczaj czytelnik pozostaje w bieżącej pozycji.

Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .