XmlReader.ReadElementContentAsLong Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает текущий элемент и возвращает содержимое в виде 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
Возвращаемое значение
Содержимое элемента как целое 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.
}
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) пространства имен элемента.
Возвращаемое значение
Содержимое элемента как целое 64-разрядное целое число со знаком.
Исключения
Объект XmlReader не расположен на элементе.
-или-
Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
Текущий элемент содержит дочерние элементы.
-или-
Содержимое элемента не может быть преобразовано в 64-разрядное целое число со знаком.
Метод вызван с аргументами null
.
Указанное локальное имя и URI пространства имен не совпадают с аналогичными параметрами текущего считываемого элемента.
Комментарии
Этот метод считывает начальный тег, содержимое элемента и перемещает средство чтения мимо тега конечного элемента. Он расширяет сущности и игнорирует инструкции и комментарии по обработке. Элемент может содержать только простое содержимое. То есть он не может иметь дочерние элементы.
Если содержимое введено xsd:long
, средство чтения возвращает 64-разрядное целое число со знаком без папки. Если содержимое не введено xsd:long
, средство чтения пытается преобразовать его в 64-разрядное целое число со знаком в соответствии с правилами, определенными в рекомендации W3C XML Schema Part 2: Datatypes .
Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.