Właściwość osi podrzędnej 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 elementów XML deklarowanej i atrybutów (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ść 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 Instrukcja przywozu (obszar 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
Koncepcje
Nazwy elementów XML deklarowanej i atrybutów (Visual Basic)