Свойство значения XML (Visual Basic)
Предоставляет доступ к значению первого элемента из коллекции объектов XElement.
object.Value
Части
Термин |
Определение |
object |
Обязательный. Коллекция объектов XElement. |
Возвращаемое значение
String, содержащая значение первого элемента коллекции, или Nothing, если коллекция пуста.
Заметки
Свойство Value упрощает доступ к значению первого элемента в коллекции объектов XElement. Это свойство сначала проверяет, содержит ли коллекция по крайней мере один объект. Если коллекция пуста, это свойство возвращает Nothing. В противном случае это свойство возвращает значение свойства Value первого элемента в коллекции.
Примечание
При обращении к значению XML-атрибута с помощью идентификатора '@', значение атрибута возвращается как String и не нужно явно задавать свойство Value.
Можно использовать свойство индексатора расширения XML для доступа к другим элементам коллекции. Дополнительные сведения см. в разделе Свойство-индексатор расширения (Visual Basic).
Наследование
Большинству пользователей не придется реализовывать IEnumerable<T>, следовательно, можно проигнорировать этот раздел.
Свойство Value является расширением свойства для типов, реализующих IEnumerable(Of XElement). Привязка этого расширенного свойства похожа на привязку методов расширения: если тип реализует один из интерфейсов и определяет свойство с именем "Value", это свойство имеет приоритет перед свойством расширения. Другими словами, свойство Value можно переопределять при помощи определения нового свойства в классе, который реализует IEnumerable(Of XElement).
Пример
В следующем примере показано использование свойства Value для доступа к первому узлу в коллекции объектов XElement. В примере используется свойство дочерней оси для получения коллекции всех дочерних узлов с именами phone, находящихся в объекте contact.
Dim contact As XElement =
<contact>
<name>Patrick Hines</name>
<phone type="home">206-555-0144</phone>
<phone type="work">425-555-0145</phone>
</contact>
Console.WriteLine("Phone number: " & contact.<phone>.Value)
Этот код отображает следующий текст:
Phone number: 206-555-0144
В следующем примере показано получение значения XML-атрибута из коллекции объектов XAttribute. В примере свойство атрибута оси применяется для отображения значения атрибута type для всех элементов phone.
Dim contact As XElement =
<contact>
<name>Patrick Hines</name>
<phone type="home">206-555-0144</phone>
<phone type="work">425-555-0145</phone>
</contact>
Dim types = contact.<phone>.Attributes("type")
For Each attr In types
Console.WriteLine(attr.Value)
Next
Этот код отображает следующий текст:
home
work
См. также
Ссылки
Свойство-индексатор расширения (Visual Basic)
Свойство дочерней оси XML (Visual Basic)
Свойство оси атрибута XML (Visual Basic)
Основные понятия
Методы расширения (Visual Basic)