Propriedade do eixo filho XML (Visual Basic)

  • Artigo

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

Sintaxe

object.<child>

Partes

Termo Definição
object Obrigatórios. Um objeto XElement, um objeto XDocument, uma coleção de objetos XElement ou uma coleção de objetos XDocument.
.< Obrigatórios. Denota o início de uma propriedade do eixo filho.
child Obrigatórios. Nome dos nós filhos a serem acessados, no formato [prefix:]name.

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

Valor Retornado

Uma coleção de objetos XElement .

Comentários

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

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

Namespaces de XML

O nome em uma propriedade de eixo filho pode usar apenas prefixos de namespace de XML declarados globalmente com a instrução Imports. Ele não pode usar prefixos de namespace de XML declarados localmente em 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 filhos denominados phone 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)

Este código exibe o seguinte texto:

Home Phone = 206-555-0144

Exemplo 2

O exemplo a seguir mostra como acessar os nós filhos nomeados phone da coleção retornada pela 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)

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 de XML. Em seguida, ele usa o prefixo do namespace para criar um literal do 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

Este código exibe o seguinte texto:

Patrick Hines

Confira também