Propriedade de Eixo Descendente XML
Fornece acesso a descendentes dos seguintes procedimentos: an XElement objeto, um XDocument objeto, uma coleção de XElement objetos ou uma coleção de XDocument objetos.
object...<descendant>
Partes
object
Obrigatório.Um objeto XElement, um objeto XDocument, uma coleção de objetos XElement ou uma coleção de objetos XDocument....<
Obrigatório.Indica o início de uma propriedade de um eixo descendente.descendant
Obrigatório.Nome dos nós descendentes a serem acessados, do formulário [prefix:] name.Parte
Descrição
prefix
Opcional.Prefixo do namespace XML para o nó descendente.Deve ser um namespace para XML global que é definido usando uma instrução Imports.
name
Obrigatório.Nome local do nó descendente.SeeNomes de elementos XML declarado e atributos.
>
Obrigatório.Indica o fim de uma propriedade de um eixo descendente.
Valor de retorno
Uma coleção de objetos XElement.
Comentários
Você pode usar uma propriedade de eixo descendente XML para acessar nós descendentes pelo nome de um objeto XElement ou XDocument, ou de uma coleção de objetos XElement ou XDocument.Use a propriedade XML Value para acessar o valor do primeiro nó descendente na coleção retornada.Para obter mais informações, consulte Propriedade Valor XML.
O compilador Visual Basic converte propriedades de eixo descendente em chamadas para o método Descendants.
Namespaces XML
O nome em uma propriedade de eixo descendente pode usar somente namespaces XML declarados globalmente com a instrução Imports.Ele não é possível usar namespaces para XML declarados localmente em literais de elemento XML.Para obter mais informações, consulte Instrução Imports (Namespace XML).
Exemplo
O exemplo a seguir mostra como acessar o valor do primeiro nó descendente chamado name e os valores de todos os nós descendentes chamados phone do objeto 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))
Esse código exibe o texto a seguir:
Name: Patrick Hines
Home Phone = 206-555-0144
O exemplo a seguir declara ns como um prefixo de namespace para XML.Ele usa o prefixo de namespace para criar um literal XML e acessar o valor do primeiro nó filho com o nome qualificado "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
Esse código exibe o texto a seguir:
Name: Patrick Hines
Consulte também
Conceitos
Nomes de elementos XML declarado e atributos