Propriedade do eixo filho XML (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.
|
||||||
> |
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 do valor 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 Instruçã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 e atributos XML declarados (Visual Basic)