Sdílet prostřednictvím

Vlastnost osy podřízeného souboru XML (Visual Basic)

  • Článek

Poskytuje přístup k podřízeným položkám jednoho z následujících objektů: XElement objektu, XDocument objektu, kolekci XElement objektů nebo kolekci XDocument objektů.

Syntaxe

object.<child>

Součástky

Pojem definice
object Povinný: Objekt XElement , XDocument objekt, kolekce XElement objektů nebo kolekce XDocument objektů.
.< Povinný: Označuje začátek vlastnosti podřízené osy.
child Povinný: Název podřízených uzlů pro přístup k formuláři [prefix:]name.

- Prefix -Volitelné. Předpona oboru názvů XML pro podřízený uzel Musí to být globální obor názvů XML definovaný příkazem Imports .
- Name -Požadované. Název místního podřízeného uzlu Viz názvy deklarovaných elementů a atributů XML.
> Povinný: Označuje konec vlastnosti podřízené osy.

Návratová hodnota

Kolekce objektů XElement.

Poznámky

Vlastnost podřízené osy XML můžete použít pro přístup k podřízeným uzlům podle názvu z objektu XElement nebo XDocument z kolekce XElement objektů nebo XDocument objektů. Použijte vlastnost XML Value pro přístup k hodnotě prvního podřízeného uzlu ve vrácené kolekci. Další informace naleznete v tématu Xml Value Property.

Kompilátor jazyka Visual Basic převede vlastnosti podřízené osy na volání metody Elements .

Obory názvů XML

Název ve vlastnosti podřízené osy může používat pouze předpony oboru názvů XML deklarované globálně s příkazem Imports . Nelze použít předpony oboru názvů XML deklarované místně v literálech elementů XML. Další informace naleznete v tématu Import – příkaz (obor názvů XML).

Příklad 1

Následující příklad ukazuje, jak získat přístup k podřízeným uzlům pojmenovaných phone z objektu 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)

Tento kód zobrazí následující text:

Home Phone = 206-555-0144

Příklad 2

Následující příklad ukazuje, jak získat přístup k podřízeným uzlům pojmenovaným phone z kolekce vrácené podřízenou contact osou vlastnost objektu 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)

Tento kód zobrazí následující text:

Home Phone = 206-555-0144

Příklad 3

Následující příklad deklaruje ns jako předponu oboru názvů XML. Potom použije předponu oboru názvů k vytvoření literálu XML a přístup k prvnímu podřízeného uzlu s kvalifikovaným názvem 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

Tento kód zobrazí následující text:

Patrick Hines

Viz také