XmlReader.ReadContentAsLong Метод

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Исходный код:

XmlReader.cs

Считывает текстовое содержимое в текущей позиции как 64-разрядное целое число со знаком.

public:
 virtual long ReadContentAsLong();

public virtual long ReadContentAsLong ();

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

Public Overridable Function ReadContentAsLong () As Long

Возвращаемое значение

Int64

Текстовое содержимое как 64-разрядное целое число со знаком.

Исключения

InvalidCastException

Недопустимая попытка приведения.

FormatException

Недопустимый формат строки.

InvalidOperationException

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Комментарии

Этот метод объединяет текст, пробелы, значительные пробелы и разделы CDATA, а также пропускает любые комментарии или инструкции по обработке. Ссылки на сущности разрешаются автоматически.

Если содержимое введено xsd:long, средство чтения возвращает 64-разрядное целое число со знаком. Если содержимое не является типизированным xsd:long, читатель пытается преобразовать его в 64-разрядное целое число со знаком в соответствии с правилами, определенными в рекомендации W3C XML Schema Part 2: Datatypes .

В следующей таблице описывается, что этот метод обрабатывает каждый тип узла.

Тип узла XML	Возвращаемое значение	Поведение модуля чтения
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Объединенное содержимое узлов текста, CDATA, пробелов и значимых пробелов, преобразованное в необходимый тип.	Перемещается к следующему тегу начального или конечного элемента. Ссылки на сущности автоматически раскрываются.
Attribute	То же, что и XmlConvert.ToXxx для значения атрибута.	Читатель остается в текущей позиции
Comment ProcessingInstruction	Пропускает инструкцию по обработке или комментарий и считывает объединенное текстовое содержимое, следующее за инструкцией по обработке или комментарием.	Перемещается к следующему тегу начального или конечного элемента. Ссылки на сущности автоматически раскрываются.
EndElement	Пустая строка.	Средство чтения остается в текущей позиции.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Возникает исключение InvalidOperationException.	Не определено, хотя обычно модуль чтения остается в текущей позиции.

Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.