Свойство значения XML (Visual Basic)
Предоставляет доступ к значению первого элемента коллекции XElement объектов.
Синтаксис
object.Value
Детали
Термин | Определение |
---|---|
object |
Обязательный. Коллекция объектов XElement. |
Возвращаемое значение
Значение String
, содержащее значение первого элемента коллекции или Nothing
если коллекция пуста.
Замечания
Свойство Value упрощает доступ к значению первого элемента в коллекции XElement объектов. Это свойство сначала проверка, содержит ли коллекция хотя бы один объект. Если коллекция пуста, это свойство возвращается Nothing
. В противном случае это свойство возвращает значение Value свойства первого элемента в коллекции.
Примечание.
При доступе к значению XML-атрибута с помощью идентификатора "@" значение атрибута возвращается в виде и String
не нужно явно указывать Value свойство.
Для доступа к другим элементам коллекции можно использовать свойство индексатора расширения XML. Дополнительные сведения см. в разделе "Свойство индексатора расширений".
Наследование
Большинству пользователей не придется реализовывать IEnumerable<T>этот раздел. Поэтому этот раздел может игнорироваться.
Это Value свойство является свойством расширения для типов, реализующих IEnumerable(Of XElement)
. Привязка этого свойства расширения похожа на привязку методов расширения: если тип реализует один из интерфейсов и определяет свойство с именем Value, это свойство имеет приоритет над свойством расширения. Другими словами, это Value свойство можно переопределить, определив новое свойство в классе, который реализует IEnumerable(Of XElement)
.
Пример 1
В следующем примере показано, как использовать 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
Пример 2
В следующем примере показано, как получить значение 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