XmlReader.ReadContentAsLong Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Źródło:

XmlReader.cs

Odczytuje zawartość tekstową na bieżącym położeniu 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 ze znakiem.

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 takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Ta metoda łączy tekst, biały znak, znaczące 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 liczbę całkowitą ze znakiem 64-bitowym. Jeśli zawartość nie jest wpisywana xsd:long, czytelnik próbuje przekonwertować ją na 64-bitową liczbę całkowitą ze znakiem zgodnie z regułami zdefiniowanymi przez rekomendację schematu XML W3C Część 2: Zalecenia dotyczące typów danych .

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, biały znak i znaczące węzły odstępu przekonwertowane 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 na bieżącym stanowisku.

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