Propriedade Valor XML (Visual Basic)
Fornece acesso ao valor do primeiro elemento de uma coleção de XElement objetos.
Sintaxe
object.Value
Partes
| Termo | Definição |
|---|---|
object |
Obrigatório. Coleção de XElement objetos. |
Devolver Valor
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.
Nota
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
