Sdílet prostřednictvím

Vlastnost osy potomků XML (Visual Basic)

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 Volitelný. 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 XElement objektů.

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.

Jmenné prostory 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

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

Name: Patrick Hines

Viz také

  • Last updated on