Właściwości osi elementu podrzędnego XML (Visual Basic)

Zapewnia dostęp do obiektów podrzędnych w jeden z następujących: XElement obiektu, XDocument obiektu, Kolekcja XElement obiektów lub kolekcja XDocument obiektów.

object.<child>

Części

Termin

Definicja

object

Wymagane.XElement Obiektu, XDocument obiektu, Kolekcja XElement obiektów lub kolekcja XDocument obiektów.

. <

Wymagane.Oznacza początek właściwość osi podrzędnej.

child

Wymagane.Nazwy węzłów podrzędnych, aby uzyskać dostęp, w formularzu prefix:name.

Część

Opis

prefix

Opcjonalne.Prefiks obszaru nazw XML dla węzła podrzędnego.Musi być globalnej przestrzeni nazw XML zdefiniowana z Imports instrukcji.

name

Wymagane.Nazwa węzła lokalnego dziecka.See Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic).

>

Wymagane.Oznacza koniec właściwości osi podrzędnej.

Wartość zwracana

Kolekcja XElement obiektów.

Uwagi

Właściwość osi podrzędnej XML można umożliwia węzły podrzędne dostępu przez nazwę z XElement lub XDocument obiektu, lub z kolekcji XElement lub XDocument obiektów.Użyj pliku XML Value właściwości w celu uzyskania dostępu do wartości pierwszego węzła podrzędnego w kolekcji zwracane.Aby uzyskać więcej informacji, zobacz Właściwość wartości XML (Visual Basic).

Visual Basic Kompilatora konwertuje właściwości osi podrzędnej do wywołań Elements metody.

Przestrzenie nazw XML

Nazwa właściwości osi podrzędnej można używać tylko nazw XML prefiksy globalnie zadeklarowana z Imports instrukcji.Nie może on używać lokalnie zadeklarowana wewnątrz literały element XML prefiksy obszarów nazw XML.Aby uzyskać więcej informacji, zobacz Imports — Instrukcja (przestrzeń nazw XML).

Przykład

Poniższy przykład ilustruje sposób uzyskać dostęp wszystkie węzły podrzędne o nazwie phone z contact obiektu.

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)

Ten kod wyświetla następujący tekst:

Home Phone = 206-555-0144

Poniższy przykład ilustruje sposób uzyskać dostęp wszystkie węzły podrzędne o nazwie phone z kolekcji, zwrócony przez contact właściwość osi podrzędnej contacts obiektu.

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)

Ten kod wyświetla następujący tekst:

Home Phone = 206-555-0144

Poniższy przykład deklaruje ns jako prefiks obszaru nazw XML.Następnie używa prefiks obszaru nazw do tworzenia literał XML i uzyskiwania dostępu pierwszego węzła podrzędnego o nazwie kwalifikowanej 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

Ten kod wyświetla następujący tekst:

Patrick Hines

Zobacz też

Informacje

XElement

Koncepcje

Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic)

Inne zasoby

Właściwości osi XML (Visual Basic)

Literały XML (Visual Basic)

Tworzenie XML w Visual Basic