Partilhar via

Propriedade XML Child Axis (Visual Basic)

  • Artigo

Fornece acesso aos filhos de um dos seguintes: um XElement objeto, um XDocument objeto, uma coleção de XElement objetos ou uma coleção de XDocument objetos.

Sintaxe

object.<child>

Partes

Termo Definição
object Obrigatório. Um XElement objeto, um XDocument objeto, uma coleção de XElement objetos ou uma coleção de XDocument objetos.
.< Obrigatório. Indica o início de uma propriedade de eixo filho.
child Obrigatório. Nome dos nós filho a acessar, do formulário [prefix:]name.

- Prefix - Opcional. Prefixo de namespace XML para o nó filho. Deve ser um namespace XML global definido com uma Imports instrução.
- Name -Necessário. Nome do nó filho local. Consulte Nomes de elementos e atributos XML declarados.
> Obrigatório. Indica o final de uma propriedade de eixo filho.

Devolver Valor

Uma coleção de XElement objetos.

Observações

Você pode usar uma propriedade de eixo filho XML para acessar nós filho pelo nome de um XElement ou XDocument objeto, ou de uma coleção de XElement ou XDocument objetos. Use a propriedade XML Value para acessar o valor do primeiro nó filho na coleção retornada. Para obter mais informações, consulte Propriedade de valor XML.

O compilador do Visual Basic converte propriedades do eixo filho em chamadas para o Elements método.

XML Namespaces

O nome em uma propriedade de eixo filho pode usar apenas prefixos de namespace XML declarados globalmente com a Imports instrução. Ele não pode usar prefixos de namespace XML declarados localmente em literais de elemento XML. Para obter mais informações, consulte Instrução de importação (namespace XML).

Exemplo 1

O exemplo a seguir mostra como acessar os nós filho nomeados phone a partir do contact objeto.

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)

Este código exibe o seguinte texto:

Home Phone = 206-555-0144

Exemplo 2

O exemplo a seguir mostra como acessar os nós filho nomeados phone da coleção retornada pela contact propriedade do eixo filho do contacts objeto.

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)

Este código exibe o seguinte texto:

Home Phone = 206-555-0144

Exemplo 3

O exemplo a seguir declara ns como um prefixo de namespace XML. Em seguida, ele usa o prefixo do namespace para criar um literal XML e acessar o primeiro nó filho com o nome ns:namequalificado.

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

Este código exibe o seguinte texto:

Patrick Hines

Consulte também