XmlReader.ReadElementContentAsObject Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает текущий элемент и возвращает содержимое в виде Object.
Перегрузки
| Имя | Описание |
|---|---|
| ReadElementContentAsObject() |
Считывает текущий элемент и возвращает содержимое в виде Object. |
| ReadElementContentAsObject(String, String) |
Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде Object. |
ReadElementContentAsObject()
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
Считывает текущий элемент и возвращает содержимое в виде Object.
public:
virtual System::Object ^ ReadElementContentAsObject();
public virtual object ReadElementContentAsObject();
abstract member ReadElementContentAsObject : unit -> obj
override this.ReadElementContentAsObject : unit -> obj
Public Overridable Function ReadElementContentAsObject () As Object
Возвращаемое значение
Объект стандартной среды CLR для наиболее подходящего типа. Свойство ValueType определяет соответствующий тип СРЕДЫ CLR. Если содержимое типируется как тип списка, этот метод возвращает массив прямоугольных объектов соответствующего типа.
Исключения
Объект XmlReader не расположен на элементе.
–или–
Метод XmlReader был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
Текущий элемент содержит дочерние элементы.
–или–
Содержимое элемента невозможно преобразовать в запрошенный тип
Метод вызывается с null аргументами.
Примеры
В следующем примере метод используется для чтения содержимого price узла. Читатель использует сведения в схеме для сопоставления содержимого с правильным типом данных.
// Create a validating reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:items", "item.xsd");
XmlReader reader = XmlReader.Create("item.xml", settings);
// Get the CLR type of the price element.
reader.ReadToFollowing("price");
Console.WriteLine(reader.ValueType);
// Return the value of the price element as Decimal object.
Decimal price = (Decimal) reader.ReadElementContentAsObject();
// Add 2.50 to the price.
price = Decimal.Add(price, 2.50m);
' Create a validating reader.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:items", "item.xsd")
Dim reader As XmlReader = XmlReader.Create("item.xml", settings)
' Get the CLR type of the price element.
reader.ReadToFollowing("price")
Console.WriteLine(reader.ValueType)
' Return the value of the price element as Decimal object.
Dim price As [Decimal] = CType(reader.ReadElementContentAsObject(), [Decimal])
' Add 2.50 to the price.
price = [Decimal].Add(price, 2.5D)
В примере используются следующие два файла в качестве входных данных.
item.xml
<item xmlns="urn:items" productID='123098'>
<name>hammer</name>
<price>9.95</price>
<supplierID>1929</supplierID>
</item>
item.xsd
<?xml version="1.0"?>
<xs:schema xmlns:tns="urn:items" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="urn:items" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string" />
<xs:element name="price" type="xs:decimal" />
<xs:element name="supplierID" type="xs:unsignedShort" />
</xs:sequence>
<xs:attribute name="productID" type="xs:unsignedInt" use="required" />
</xs:complexType>
</xs:element>
</xs:schema>
Комментарии
Этот метод считывает начальный тег, содержимое элемента и перемещает читателя мимо тега конечного элемента. Он расширяет сущности и игнорирует инструкции и примечания. Элемент может содержать только простое содержимое. То есть у него не может быть дочерних элементов.
Дополнительные сведения см. в разделе "Примечания" эталонной XmlReader страницы и рекомендации по xml-схеме W3C 2.
Сведения об асинхронной версии этого метода см. в разделе ReadElementContentAsObjectAsync.
Применяется к
ReadElementContentAsObject(String, String)
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде Object.
public:
virtual System::Object ^ ReadElementContentAsObject(System::String ^ localName, System::String ^ namespaceURI);
public virtual object ReadElementContentAsObject(string localName, string namespaceURI);
abstract member ReadElementContentAsObject : string * string -> obj
override this.ReadElementContentAsObject : string * string -> obj
Public Overridable Function ReadElementContentAsObject (localName As String, namespaceURI As String) As Object
Параметры
- localName
- String
Локальное имя элемента.
- namespaceURI
- String
URI пространства имен элемента.
Возвращаемое значение
Объект стандартной среды CLR для наиболее подходящего типа. Свойство ValueType определяет соответствующий тип СРЕДЫ CLR. Если содержимое типируется как тип списка, этот метод возвращает массив прямоугольных объектов соответствующего типа.
Исключения
Объект XmlReader не расположен на элементе.
–или–
Метод XmlReader был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".
Текущий элемент содержит дочерние элементы.
–или–
Содержимое элемента невозможно преобразовать в запрошенный тип.
Метод вызывается с null аргументами.
Указанные локальные имена и URI пространства имен не соответствуют URI текущего элемента, считываемого.
Комментарии
Этот метод считывает начальный тег, содержимое элемента и перемещает читателя мимо тега конечного элемента. Он расширяет сущности и игнорирует инструкции и примечания. Элемент может содержать только простое содержимое. То есть у него не может быть дочерних элементов.
Дополнительные сведения см. в разделе "Примечания" эталонной XmlReader страницы и рекомендации по xml-схеме W3C 2.