Propriedade de eixo XML filho (Visual Basic)
Fornece acesso aos descendentes de um dos seguintes: um objeto XElement, um objeto XDocument, uma coleção de objetos XElement ou uma coleção de objetos XDocument.
object.<child>
Partes
Termo |
Definição |
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.
ParteDescriçã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.Consulte Nomes de elementos declarados XML e atributos (Visual Basic).
|
> |
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 Value XML (Visual Basic).
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 Declaraçã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
Referência
Conceitos
Nomes de elementos declarados XML e atributos (Visual Basic)