Udostępnij za pośrednictwem

Właściwości osi elementu podrzędnego XML (Visual Basic)

  • Artykuł

Zapewnia dostęp do elementów podrzędnych jednego z następujących elementów: XElement obiektu, XDocument obiektu, kolekcji obiektów lub kolekcji XElementXDocument obiektów.

Składnia

object.<child>

generatora

Termin Definicja
object Wymagany. XElement Obiekt, XDocument obiekt, kolekcja XElement obiektów lub kolekcja XDocument obiektów.
.< Wymagany. Określa początek właściwości osi podrzędnej.
child Wymagany. Nazwa węzłów podrzędnych do uzyskania dostępu do formularza [prefix:]name.

- Prefix -Opcjonalne. Prefiks przestrzeni nazw XML dla węzła podrzędnego. Musi być globalną przestrzenią nazw XML zdefiniowaną za pomocą instrukcji Imports .
- Name -Wymagane. Nazwa lokalnego węzła podrzędnego. Zobacz Nazwy zadeklarowanych elementów XML i atrybutów.
> Wymagany. Określa koniec właściwości osi podrzędnej.

Wartość zwracana

Kolekcja obiektów XElement.

Uwagi

Możesz użyć właściwości osi podrzędnej XML, aby uzyskać dostęp do węzłów podrzędnych według nazwy z XElement obiektu lub XDocument lub kolekcji XElement obiektów lub XDocument . Użyj właściwości XML Value , aby uzyskać dostęp do wartości pierwszego węzła podrzędnego w zwróconej kolekcji. Aby uzyskać więcej informacji, zobacz Właściwość wartości XML.

Kompilator języka Visual Basic konwertuje właściwości osi podrzędnej na wywołania Elements metody .

Przestrzenie nazw XML

Nazwa we właściwości osi podrzędnej może używać tylko prefiksów przestrzeni nazw XML zadeklarowanych globalnie z instrukcją Imports . Nie może używać prefiksów przestrzeni nazw XML zadeklarowanych lokalnie w literałach elementu XML. Aby uzyskać więcej informacji, zobacz Import Statement (XML Namespace).

Przykład 1

W poniższym przykładzie pokazano, jak uzyskać dostęp do węzłów podrzędnych o nazwie phone z contact obiektu .

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)

Ten kod wyświetla następujący tekst:

Home Phone = 206-555-0144

Przykład 2

W poniższym przykładzie pokazano, jak uzyskać dostęp do węzłów podrzędnych o nazwie phone z kolekcji zwróconej przez contact właściwość osi podrzędnej contacts obiektu.

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)

Ten kod wyświetla następujący tekst:

Home Phone = 206-555-0144

Przykład 3

Poniższy przykład deklaruje ns jako prefiks przestrzeni nazw XML. Następnie używa prefiksu przestrzeni nazw, aby utworzyć literał XML i uzyskać dostęp do pierwszego węzła podrzędnego o kwalifikowanej nazwie 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

Ten kod wyświetla następujący tekst:

Patrick Hines

Zobacz też