Vlastnost osy nástupce XML (Visual Basic)

Článek
03/12/2024

Poskytuje přístup k potomkům následujících: XElement objektu, objektu XDocument , kolekci XElement objektů nebo kolekci XDocument objektů.

Syntaxe

object...<descendant>

Součástky

object Požadované. Objekt XElement , XDocument objekt, kolekce XElement objektů nebo kolekce XDocument objektů.

...< Požadované. Označuje začátek vlastnosti osy potomků.

descendant Požadované. Název následnických uzlů pro přístup k formuláři [prefix:]name.

Část	Popis
`prefix`	Nepovinné. Předpona oboru názvů XML pro následný uzel Musí být globální obor názvů XML, který je definován pomocí `Imports` příkazu.
`name`	Povinný: Místní název potomku uzlu. Viz názvy deklarovaných elementů a atributů XML.

> Požadované. Označuje konec vlastnosti osy potomků.

Návratová hodnota

Kolekce objektů XElement.

Poznámky

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

Kompilátor jazyka Visual Basic převede vlastnosti potomků osy na Descendants volání metody.

Obory názvů XML

Název ve vlastnosti osy potomků může používat pouze obory názvů XML deklarované globálně pomocí Imports příkazu. Nelze použít obory 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 hodnotě prvního potomkového uzlu s názvem name a hodnotami všech následnických uzlů pojmenovaných phone z objektu contacts .

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

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

Name: Patrick Hines

Home Phone = 206-555-0144

Příklad 2

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 hodnotě prvního podřízeného uzlu s kvalifikovaným názvem 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