Partilhar via

Propriedade Valor XML (Visual Basic)

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

Sintaxe

object.Value

Partes

Período Definição
object Obrigatório Coleção de XElement objetos.

Valor de retorno

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

Observações

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

Herança

A maioria dos usuários não terá que 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)o . 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 do 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 attribute axis para exibir o type valor do 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

Ver também

  • Last updated on