Dela via

XML-egenskap för underordnad axel (Visual Basic)

  • Artikel

Ger åtkomst till följande underordnade objekt: ett XElement objekt, ett XDocument objekt, en samling XElement objekt eller en samling XDocument objekt.

Syntax

object...<descendant>

Delar

object Krävs. Ett XElement objekt, ett XDocument objekt, en samling XElement objekt eller en samling XDocument objekt.

...< Krävs. Anger början av en egenskap för underordnad axel.

descendant Krävs. Namnet på de underordnade noder som ska kommas åt, i formuläret [prefix:]name.

Delvis beskrivning
prefix Valfritt. XML-namnområdesprefix för den underordnade noden. Måste vara ett globalt XML-namnområde som definieras med hjälp av en Imports -instruktion.
name Obligatoriska. Lokalt namn på den underordnade noden. Se Namn på deklarerade XML-element och attribut.

> Krävs. Anger slutet på en underordnad axelegenskap.

Returvärde

En samling XElement objekt.

Kommentarer

Du kan använda en XML-egenskap för underordnad axel för att komma åt underordnade noder efter namn från ett XElement objekt eller XDocument från en samling eller XElementXDocument objekt. Använd XML-egenskapen Value för att komma åt värdet för den första underordnade noden i den returnerade samlingen. Mer information finns i XML-värdeegenskap.

Visual Basic-kompilatorn konverterar egenskaper för underordnad axel till anrop till Descendants metoden.

XML-namnområden

Namnet i en egenskap för underordnad axel kan endast använda XML-namnområden som deklarerats globalt med -instruktionen Imports . Det går inte att använda XML-namnområden som deklarerats lokalt i XML-elementliteraler. Mer information finns i Importinstruktor (XML-namnområde).

Exempel 1

I följande exempel visas hur du kommer åt värdet för den första underordnade noden med namnet name och värdena för alla underordnade noder med namnet phone från contacts objektet.

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))

Den här koden visar följande text:

Name: Patrick Hines

Home Phone = 206-555-0144

Exempel 2

I följande exempel deklareras som ett XML-namnområdesprefix ns . Den använder sedan prefixet för namnområdet för att skapa en XML-literal och komma åt värdet för den första underordnade noden med det kvalificerade namnet 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

Den här koden visar följande text:

Name: Patrick Hines

Se även