Propriedade XML do eixo filho
Fornece acesso para os filhos de um destes procedimentos: an XElement objeto, um XDocument objeto, uma coleção de XElement objetos ou uma coleção de XDocument objetos.
object.<child>
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 do eixo filho.child
Obrigatório.Nome dos nós-filho a serem acessados, do formulário [prefix:] name.Parte
Descrição
prefix
Opcional.Prefixo namespace para XML para o nó filho.Deve ser um namespace para XML global definido com uma declaração Imports.
name
Obrigatório.Nome local do nó filho.SeeNomes de elementos XML declarado e atributos.
>
Obrigatório.Indica o início de uma propriedade do eixo filho.
Valor de retorno
Uma coleção de objetos XElement.
Comentários
Você pode usar um propriedade do eixo filho XML para acessar os nós filho por 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 filho em chamadas para o método Elements.
Namespaces XML
O nome em uma propriedade de eixo filho pode usar somente namespaces XML declarados globalmente com a declaração Imports.Não é possível usar prefixos namespace 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 os nós filho chamados phone a partir do objeto contact.
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)
Esse código exibe o texto a seguir:
Home Phone = 206-555-0144
O exemplo a seguir mostra como acessar os nós filho chamados phone a partir da coleção retornada pelo propriedade do eixo filho contact do objeto contacts.
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)
Esse código exibe o texto a seguir:
Home Phone = 206-555-0144
O exemplo a seguir declara ns como um prefixo de namespace para XML.Ele então usa o prefixo de namespace para criar um literal XML e acessar o primeiro nó filho com o nome qualificado 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
Esse código exibe o texto a seguir:
Patrick Hines
Consulte também
Conceitos
Nomes de elementos XML declarado e atributos