XmlReader.ReadElementContentAsLong Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

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

Перегрузки

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

ReadElementContentAsLong()

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

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

ReadElementContentAsLong(String, String)

Проверяет, совпадают ли указанные локальное имя и 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 пространства имен не совпадают с аналогичными параметрами текущего считываемого элемента.

Комментарии

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

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

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