Propriedade do valor XML (Visual Basic)

  • Artigo

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

Sintaxe

object.Value

Partes

Termo Definição
object Obrigatórios. Coleção de objetos XElement.

Valor Retornado

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

Comentários

A propriedade Value facilita o acesso ao valor do primeiro elemento em uma coleção de objetos XElement. 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 propriedade Value 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 propriedade Value.

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 Propriedade do indexador de extensão.

Herança

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

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

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 objetos XAttribute. O exemplo usa a propriedade do eixo do atributo para exibir o valor do atributo type para todos os elementos phone.

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

Confira também