Поделиться через


Свойство значения XML (Visual Basic)

Предоставляет доступ к значению первого элемента из коллекции объектов XElement.

object.Value

Части

Термин

Определение

object

Обязательный. Коллекция объектов XElement.

Возвращаемое значение

String, содержащая значение первого элемента коллекции, или Nothing, если коллекция пуста.

Заметки

Свойство Value упрощает доступ к значению первого элемента в коллекции объектов XElement. Это свойство сначала проверяет, содержит ли коллекция по крайней мере один объект. Если коллекция пуста, это свойство возвращает Nothing. В противном случае это свойство возвращает значение свойства Value первого элемента в коллекции.

Примечание

При обращении к значению XML-атрибута с помощью идентификатора '@', значение атрибута возвращается как String и не нужно явно задавать свойство Value.

Можно использовать свойство индексатора расширения XML для доступа к другим элементам коллекции. Дополнительные сведения см. в разделе Свойство-индексатор расширения (Visual Basic).

Наследование

Большинству пользователей не придется реализовывать IEnumerable, следовательно, можно проигнорировать этот раздел.

Свойство 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

См. также

Ссылки

XElement

IEnumerable

Свойство-индексатор расширения (Visual Basic)

Свойство дочерней оси XML (Visual Basic)

Свойство оси атрибута XML (Visual Basic)

Основные понятия

Методы расширения (Visual Basic)

Другие ресурсы

Свойства оси XML (Visual Basic)

XML-литералы (Visual Basic)

Создание XML в Visual Basic