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


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

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

object.<child>

Части

Термин

Определение

object

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

.<

Обязательный.Обозначает начало свойства дочерней оси.

child

Обязательный.Имя дочерних узлов для доступа, в форме [prefix:]name.

ЧастьОписание
prefix Необязательный.Префикс пространства имен XML для дочернего узла.Должно быть глобальным пространством имен XML, определенным при помощи оператора Imports.
name Обязательный.Локальное имя дочернего узла.Дополнительные сведения см. в разделе Имена объявляемых элементов и атрибутов XML (Visual Basic).

>

Обязательный.Обозначает конец свойства дочерней оси.

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

Коллекция объектов XElement.

Заметки

Можно использовать свойство оси дочернего XML для получения доступа к дочернему узлу по имени из объекта XElement или XDocument или из коллекции объектов XElement или XDocument.Для доступа к значению первого дочернего узла в возвращаемой коллекции используется свойство Value XML.Дополнительные сведения см. в разделе Свойство значения XML (Visual Basic).

Компилятор Visual Basic преобразует свойства дочерней оси в вызовы метода Elements.

Пространства имен XML

Имя в свойстве дочерней оси может использовать только префиксы пространства имен XML, объявленные глобально помощью инструкции Imports.Оно не может использовать префиксы пространства имен XML, объявленные локально с помощью литералов XML-элемента.Дополнительные сведения см. в разделе Оператор Imports (пространство имен XML).

Пример

В следующем примере показано, как получить доступ к дочернему узлу с именем 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>

Dim homePhone = From hp In contact.<phone> 
                Where contact.<phone>.@type = "home" 
                Select hp

Console.WriteLine("Home Phone = {0}", homePhone(0).Value)

В этом коде отображается следующий текст:

Home Phone = 206-555-0144

В следующем примере показано, как получить доступ к дочернему узлу с именем phone из коллекции, возвращенной свойством дочерней оси contact объекта contacts.

Dim contacts As XElement = 
    <contacts>
        <contact>
            <name>Patrick Hines</name>
            <phone type="home">206-555-0144</phone>
        </contact>
        <contact>
            <name>Lance Tucker</name>
            <phone type="work">425-555-0145</phone>
        </contact>
    </contacts>

Dim homePhone = From contact In contacts.<contact> 
                Where contact.<phone>.@type = "home" 
                Select contact.<phone>

Console.WriteLine("Home Phone = {0}", homePhone(0).Value)

В этом коде отображается следующий текст:

Home Phone = 206-555-0144

В следующем примере ns объявляется как префикс пространства имен XML.Затем используется префикс пространства имен для создания XML-литерала и доступа к первому дочернему узлу, имеющему полное имя ns:name.

Imports <xmlns:ns = "http://SomeNamespace"> 

Class TestClass4

    Shared Sub TestPrefix()
        Dim contact = <ns:contact>
                        <ns:name>Patrick Hines</ns:name>
                      </ns:contact>
        Console.WriteLine(contact.<ns:name>.Value)
    End Sub

End Class

В этом коде отображается следующий текст:

Patrick Hines

См. также

Ссылки

XElement

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

Имена объявляемых элементов и атрибутов XML (Visual Basic)

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

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

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

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