XML-leszármazott tengely tulajdonsága (Visual Basic)

Cikk
03/05/2024

Hozzáférést biztosít a következők leszármazottaihoz: objektumhoz XElement , XDocument objektumhoz, objektumgyűjteményhez XElement vagy objektumgyűjteményhez XDocument .

Syntax

object...<descendant>

Részek

object Szükséges. Objektum XElement , XDocument objektum, objektumgyűjtemény XElement vagy objektumgyűjtemény XDocument .

...< Szükséges. Egy leszármazott tengelytulajdonság kezdetét jelöli.

descendant Szükséges. A hozzáférést biztosító leszármazó csomópontok neve az [prefix:]name.

Része	Leírás
`prefix`	Opcionális. A leszármazott csomópont XML-névtér-előtagja. Egy utasítással `Imports` definiált globális XML-névtérnek kell lennie.
`name`	Szükséges. A leszármazott csomópont helyi neve. Lásd : Deklarált XML-elemek és attribútumok neve.

> Szükséges. A leszármazott tengely tulajdonságának végét jelöli.

Visszatérési érték

Objektumok gyűjteménye XElement .

Megjegyzések

Az XML-leszármazott tengely tulajdonságával név alapján, vagy XElement objektumból, illetve gyűjteményből vagy XDocument XDocument objektumgyűjteményből XElement érheti el a leszármazó csomópontokat. Az XML-tulajdonság Value használatával érheti el a visszaadott gyűjtemény első leszármazott csomópontjának értékét. További információ: XML Value Property.

A Visual Basic fordító a leszármazott tengely tulajdonságait metódussá Descendants konvertálja.

XML-névterek

A leszármazott tengelytulajdonságok neve csak az utasítással Imports globálisan deklarált XML-névtereket használhatja. Nem használhat helyileg deklarált XML-névtereket az XML-elemkonstansokban. További információ: Import Statement (XML Namespace).

1. példa

Az alábbi példa bemutatja, hogyan érheti el az első elnevezett name leszármazott csomópont és az objektumról contacts elnevezett phone összes leszármazott csomópont értékét.

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

Ez a kód a következő szöveget jeleníti meg:

Name: Patrick Hines

Home Phone = 206-555-0144

2. példa

Az alábbi példa XML-névtérelőtagként deklarál ns . Ezután a névtér előtagjával létrehoz egy XML-konstanst, és hozzáfér az első gyermekcsomópont értékéhez a minősített névvel 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