Compartilhar via

Propriedade eixo filho XML (Visual Basic)

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

Prazo 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 serem acessados, do formulário [prefix:]name.

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

Valor de retorno

Uma coleção de XElement objetos.

Observações

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

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

Namespaces de XML

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

Exemplo 1

O exemplo a seguir mostra como acessar os nós filho nomeados phone 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