Compartilhar via

Propriedade XML Value (Visual Basic)

Fornece acesso ao valor do primeiro elemento de uma coleção de XElement objetos.

Sintaxe

object.Value

Partes

Prazo Definição
object Obrigatório Coleção de XElement objetos.

Valor de retorno

Um String que contém o valor do primeiro elemento da coleção ou Nothing se a coleção está vazia.

Observações

A Value propriedade facilita o acesso ao valor do primeiro elemento em uma coleção de XElement objetos. Essa propriedade verifica primeiro se a coleção contém pelo menos um objeto. Se a coleção estiver vazia, essa propriedade retornará Nothing. Caso contrário, essa propriedade retornará o valor da Value propriedade do primeiro elemento na coleção.

Observação

Quando você acessa o valor de um atributo XML usando o identificador '@', o valor do atributo é retornado como um String e você não precisa especificar explicitamente a Value propriedade.

Para acessar outros elementos em uma coleção, você pode usar a propriedade do indexador de extensão XML. Para obter mais informações, consulte a Propriedade Extension Indexer.

Herança

A maioria dos usuários não precisará implementar IEnumerable<T>e, portanto, pode ignorar esta seção.

A Value propriedade é uma propriedade de extensão para tipos que implementam IEnumerable(Of XElement). A associação dessa propriedade de extensão é como a associação de métodos de extensão: se um tipo implementa uma das interfaces e define uma propriedade que tem o nome "Value", essa propriedade tem precedência sobre a propriedade de extensão. Em outras palavras, essa Value propriedade pode ser substituída definindo uma nova propriedade em uma classe que implementa IEnumerable(Of XElement).

Exemplo 1

O exemplo a seguir mostra como usar a Value propriedade para acessar o primeiro nó em uma coleção de XElement objetos. O exemplo usa a propriedade de eixo filho para obter a coleção de todos os nós filho nomeados phone que estão no 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>

Console.WriteLine("Phone number: " & contact.<phone>.Value)

Este código exibe o seguinte texto:

Phone number: 206-555-0144

Exemplo 2

O exemplo a seguir mostra como obter o valor de um atributo XML de uma coleção de XAttribute objetos. O exemplo usa a propriedade do eixo de atributo para exibir o valor do type atributo para todos os phone elementos.

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 types = contact.<phone>.Attributes("type")

For Each attr In types
  Console.WriteLine(attr.Value)
Next

Este código exibe o seguinte texto:

home
work

Consulte também

  • Last updated on