XmlReader.ReadElementContentAsLong Метод

Определение

Считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком.Reads the current element and returns the contents as a 64-bit signed integer.

Перегрузки

ReadElementContentAsLong()

Считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком.Reads the current element and returns the contents as a 64-bit signed integer.

ReadElementContentAsLong(String, String)

Проверяет, совпадают ли указанные локальное имя и URI пространства имен с таковыми для текущего элемента, затем считывает текущий элемент и возвращает содержимое как 64-разрядное целое число со знаком.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 64-bit signed integer.

ReadElementContentAsLong()

Считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком.Reads the current element and returns the contents as a 64-bit signed integer.

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-разрядное целое число со знаком.The element content as a 64-bit signed integer.

Исключения

Объект XmlReader не расположен на элементе.The XmlReader is not positioned on an element.

-или--or- Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Текущий элемент содержит дочерние элементы.The current element contains child elements.

-или--or-

Содержимое элемента не может быть преобразовано в 64-разрядное целое число со знаком.The element content cannot be converted to a 64-bit signed integer.

Метод вызван с аргументами null.The method is called with null arguments.

Примеры

В следующем примере метод используется ReadElementContentAsLong для чтения содержимого longValue элемента.The following example uses the ReadElementContentAsLong method to read the content of the longValue element.

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.The example uses the dataFile.xml file as input.

<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>

Комментарии

Этот метод считывает начальный тег, содержимое элемента и перемещает модуль чтения после тега конечного элемента.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Он расширяет сущности и игнорирует инструкции по обработке и комментарии.It expands entities and ignores processing instructions and comments. Элемент может содержать только простое содержимое.The element can only contain simple content. То есть у него не может быть дочерних элементов.That is, it cannot have child elements.

Если содержимое типизировано xsd:long , средство чтения возвращает неупакованное 64-разрядное целое число со знаком.If the content is typed xsd:long, the reader returns an unboxed 64-bit signed integer. Если содержимое не типизировано xsd:long , модуль чтения пытается преобразовать его в 64-разрядное целое число со знаком в соответствии с правилами, определенными в рекомендациях консорциума W3C по схеме XML, часть 2: типы данных.If the content is not typed xsd:long, the reader attempts to convert it to a 64-bit signed integer according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.For more information, see the Remarks section of the XmlReader reference page.

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

ReadElementContentAsLong(String, String)

Проверяет, совпадают ли указанные локальное имя и URI пространства имен с таковыми для текущего элемента, затем считывает текущий элемент и возвращает содержимое как 64-разрядное целое число со знаком.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 64-bit signed integer.

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

Локальное имя элемента.The local name of the element.

namespaceURI
String

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

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

Int64

Содержимое элемента как целое 64-разрядное целое число со знаком.The element content as a 64-bit signed integer.

Исключения

Объект XmlReader не расположен на элементе.The XmlReader is not positioned on an element.

-или--or- Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Текущий элемент содержит дочерние элементы.The current element contains child elements.

-или--or-

Содержимое элемента не может быть преобразовано в 64-разрядное целое число со знаком.The element content cannot be converted to a 64-bit signed integer.

Метод вызван с аргументами null.The method is called with null arguments.

Указанное локальное имя и URI пространства имен не совпадают с аналогичными параметрами текущего считываемого элемента.The specified local name and namespace URI do not match that of the current element being read.

Комментарии

Этот метод считывает начальный тег, содержимое элемента и перемещает модуль чтения после тега конечного элемента.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Он расширяет сущности и игнорирует инструкции по обработке и комментарии.It expands entities and ignores processing instructions and comments. Элемент может содержать только простое содержимое.The element can only contain simple content. То есть у него не может быть дочерних элементов.That is, it cannot have child elements.

Если содержимое типизировано xsd:long , средство чтения возвращает неупакованное 64-разрядное целое число со знаком.If the content is typed xsd:long, the reader returns an unboxed 64-bit signed integer. Если содержимое не типизировано xsd:long , модуль чтения пытается преобразовать его в 64-разрядное целое число со знаком в соответствии с правилами, определенными в рекомендациях консорциума W3C по схеме XML, часть 2: типы данных.If the content is not typed xsd:long, the reader attempts to convert it to a 64-bit signed integer according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.For more information, see the Remarks section of the XmlReader reference page.

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