Свойство значения 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

См. также