Propriedade Value XML (Visual Basic)
Fornece acesso ao valor do primeiro elemento de uma coleção de objetos XElement.
object.Value
Partes
Termo |
Definição |
object |
Obrigatório.Coleção de objetos XElement. |
Valor de retorno
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 torna fácil acessar o valor do primeiro elemento em uma coleção de objetos XElement.Essa propriedade primeiro verifica se a coleção contém pelo menos um objeto.Se a coleção está vazia, essa propriedade retornará Nothing.Caso contrário, essa propriedade retorna o valor da propriedade Value do primeiro elemento na coleção.
.gif "Observaçã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 o Value propriedade. |
Para acessar outros elementos em uma coleção, você pode use a propriedade indexador de extensão XML.Para obter mais informações, consulte Propriedade do indexador de extensão (Visual Basic).
Herança
A maioria dos usuários não será necessário 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 vinculação da propriedade essa extensão é como a vinculação dos métodos de extensão: se um tipo implementa uma das interfaces e define uma propriedade que tem o nome "Valor", essa propriedade tem precedência sobre a propriedade de extensão.Em outras palavras, essa propriedade Value pode ser substituída ao definir uma nova propriedade em uma classe que implementa IEnumerable(Of XElement).
Exemplo
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 o propriedade do eixo filho para obter a coleção de todos os nós chamado phone que estão no contact objeto filho.
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)
Esse código exibe o texto a seguir:
Phone number: 206-555-0144
O exemplo a seguir mostra como obter o valor de um atributo XML de uma coleção de objetos XAttribute.O exemplo usa o propriedade do eixo de 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
Esse código exibe o texto a seguir:
home
work
Consulte também
Referência
Propriedade do indexador de extensão (Visual Basic)
Propriedade de eixo XML filho (Visual Basic)
Propriedade de eixo de atributo XML (Visual Basic)
Conceitos
Métodos de extensão (Visual Basic)