Dela via

XML-underaxelegenskap (Visual Basic)

  • Artikel

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

Syntax

object.<child>

Delar

Period Definition
object Obligatoriska. Ett XElement objekt, ett XDocument objekt, en samling XElement objekt eller en samling XDocument objekt.
.< Obligatoriska. Anger början på en underordnad axelegenskap.
child Obligatoriska. Namnet på de underordnade noder som ska kommas åt, i formuläret [prefix:]name.

- Prefix -Valfri. XML-namnområdesprefix för den underordnade noden. Måste vara ett globalt XML-namnområde som definierats med en Imports -instruktion.
- Name -Krävs. Namn på lokal underordnad nod. Se Namn på deklarerade XML-element och attribut.
> Obligatoriska. Anger slutet på en underordnad axelegenskap.

Returvärde

En samling XElement objekt.

Kommentarer

Du kan använda en underaxelegenskap för XML för att komma åt underordnade noder efter namn från ett XElement objekt XDocument eller 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 underordnade axelegenskaper till anrop till Elements metoden.

XML-namnområden

Namnet i en underaxelegenskap kan endast använda XML-namnområdesprefix som deklarerats globalt med -instruktionen Imports . Det går inte att använda XML-namnområdesprefix 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 de underordnade noderna med namnet phone från contact objektet.

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)

Den här koden visar följande text:

Home Phone = 206-555-0144

Exempel 2

I följande exempel visas hur du kommer åt de underordnade noderna med namnet phone från samlingen som returneras av objektets contactcontacts underordnade axelegenskap.

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)

Den här koden visar följande text:

Home Phone = 206-555-0144

Exempel 3

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 den första underordnade noden med det kvalificerade namnet 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

Den här koden visar följande text:

Patrick Hines

Se även