XmlReader.ReadElementContentAsLong Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

Перегрузки

Имя	Описание
ReadElementContentAsLong()	Считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком.
ReadElementContentAsLong(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком.

ReadElementContentAsLong()

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

XmlReader.cs

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

public:
 virtual long ReadElementContentAsLong();

public virtual long ReadElementContentAsLong();

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

Public Overridable Function ReadElementContentAsLong () As Long

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

Int64

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

Исключения

InvalidOperationException

Объект XmlReader не расположен на элементе.

–или–

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

XmlException

Текущий элемент содержит дочерние элементы.

–или–

Содержимое элемента нельзя преобразовать в 64-разрядное целое число со знаком.

ArgumentNullException

Метод вызывается с null аргументами.

Примеры

В следующем примере метод используется ReadElementContentAsLong для чтения содержимого longValue элемента.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("longValue");
     long number = reader.ReadElementContentAsLong();
     // Do some processing with the number object.
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("longValue")
  Dim number As Long = reader.ReadElementContentAsLong()
  ' Do some processing with the number object.
End Using

В этом примере файл используется dataFile.xml в качестве входных данных.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Комментарии

Этот метод считывает начальный тег, содержимое элемента и перемещает читателя мимо тега конечного элемента. Он расширяет сущности и игнорирует инструкции и примечания. Элемент может содержать только простое содержимое. То есть у него не может быть дочерних элементов.

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

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

ReadElementContentAsLong(String, String)

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

XmlReader.cs

Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком.

public:
 virtual long ReadElementContentAsLong(System::String ^ localName, System::String ^ namespaceURI);

public virtual long ReadElementContentAsLong(string localName, string namespaceURI);

abstract member ReadElementContentAsLong : string * string -> int64
override this.ReadElementContentAsLong : string * string -> int64

Public Overridable Function ReadElementContentAsLong (localName As String, namespaceURI As String) As Long

Параметры

localName

String

Локальное имя элемента.

namespaceURI

String

URI пространства имен элемента.

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

Int64

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

Исключения

InvalidOperationException

Объект XmlReader не расположен на элементе.

–или–

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

XmlException

Текущий элемент содержит дочерние элементы.

–или–

Содержимое элемента нельзя преобразовать в 64-разрядное целое число со знаком.

ArgumentNullException

Метод вызывается с null аргументами.

ArgumentException

Указанные локальные имена и URI пространства имен не соответствуют URI текущего элемента, считываемого.

Комментарии

Этот метод считывает начальный тег, содержимое элемента и перемещает читателя мимо тега конечного элемента. Он расширяет сущности и игнорирует инструкции и примечания. Элемент может содержать только простое содержимое. То есть у него не может быть дочерних элементов.

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

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