Udostępnij za pośrednictwem


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

Zapewnia dostęp do obiektów podrzędnych z następujących: XElement obiektu, XDocument obiektu, Kolekcja XElement obiektów lub kolekcja XDocument obiektów.

object...<descendant>

Części

  • object
    Wymagane.XElement Obiektu, XDocument obiektu, Kolekcja XElement obiektów lub kolekcja XDocument obiektów.

  • ... <
    Wymagane.Oznacza początek właściwości podrzędnych osi.

  • descendant
    Wymagane.Nazwy węzłów podrzędnych, aby uzyskać dostęp, w formularzu prefix:name.

    Część

    Opis

    prefix

    Opcjonalne.Prefiks obszaru nazw XML dla węzłów podrzędnych.Musi być globalne nazw XML, który jest zdefiniowany za pomocą Imports instrukcji.

    name

    Wymagane.Nazwa lokalna węzłów podrzędnych.See Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic).

  • >
    Wymagane.Oznacza koniec właściwości podrzędnych osi.

Wartość zwracana

Kolekcja XElement obiektów.

Uwagi

Właściwości podrzędnych osi XML można użyć do uzyskania dostępu do węzłów podrzędnych przez nazwę z XElement lub XDocument obiektu, lub z kolekcji XElement lub XDocument obiektów.Użyj pliku XML Value właściwości w celu uzyskania dostępu do wartości pierwszego węzła podrzędnego w kolekcji zwracane.Aby uzyskać więcej informacji, zobacz Właściwość wartości XML (Visual Basic).

Visual Basic Kompilatora konwertuje właściwości podrzędnych osi wywołania Descendants metody.

Przestrzenie nazw XML

Nazwa właściwości podrzędnych osi można używać tylko nazw XML globalnie zadeklarowana z Imports instrukcji.Nie może on używać przestrzeni nazw XML lokalnie zadeklarowana wewnątrz literały element XML.Aby uzyskać więcej informacji, zobacz Imports — Instrukcja (przestrzeń nazw XML).

Przykład

Poniższy przykład ilustruje sposób do uzyskania dostępu do wartości pierwszego węzła podrzędnego o nazwie name i wartości wszystkich węzłów podrzędnych o nazwie phone z contacts obiektu.

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

Console.WriteLine("Name: " & contacts...<name>.Value)

Dim homePhone = From phone In contacts...<phone> 
                Select phone.Value

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

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

Name: Patrick Hines

Home Phone = 206-555-0144

Poniższy przykład deklaruje ns jako prefiks obszaru nazw XML.Następnie używa prefiks obszaru nazw do tworzenia literał XML i uzyskiwania dostępu wartość pierwszego węzła podrzędnego o nazwie kwalifikowanej ns:name.

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

Class TestClass2

    Shared Sub TestPrefix()
        Dim contacts = 
            <ns:contacts>
                <ns:contact>
                    <ns:name>Patrick Hines</ns:name>
                </ns:contact>
            </ns:contacts>

        Console.WriteLine("Name: " & contacts...<ns:name>.Value)
    End Sub 

End Class

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

Name: Patrick Hines

Zobacz też

Informacje

XElement

Koncepcje

Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic)

Inne zasoby

Właściwości osi XML (Visual Basic)

Literały XML (Visual Basic)

Tworzenie XML w Visual Basic