XmlReader.ReadElementContentAsLong Метод

Определение

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

Перегрузки

ReadElementContentAsLong()

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

ReadElementContentAsLong(String, String)

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

ReadElementContentAsLong()

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

public virtual long ReadElementContentAsLong ();

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

Int64

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

Исключения

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

-или-

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

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

-или-

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

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

Примеры

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

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

В примере в качестве входных данных используется файл 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-разрядное целое число со знаком в соответствии с правилами, определенными рекомендацией W3C XML Schema Part 2: Datatypes .

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

Применяется к

ReadElementContentAsLong(String, String)

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

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

Параметры

localName
String

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

namespaceURI
String

Универсальный код ресурса (URI) пространства имен элемента.

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

Int64

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

Исключения

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

-или-

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

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

-или-

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

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

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

Комментарии

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

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

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

Применяется к