Compartilhar via


Propriedade de eixo XML descendente (Visual Basic)

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

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.Consulte Nomes de elementos declarados XML e atributos (Visual Basic).

  • >
    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 Value XML (Visual Basic).

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 Declaraçã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

Referência

XElement

Conceitos

Nomes de elementos declarados XML e atributos (Visual Basic)

Outros recursos

Propriedades de eixo XML (Visual Basic)

Literais XML (Visual Basic)

Criando XML no Visual Basic