Propriedade Valor XML
Fornece acesso ao valor do primeiro elemento de uma coleção de objetos XElement.
object.Value
Partes
- 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 '@' , a cada valor tributos é retornado sistema autônomo 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.
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 ligação da propriedade extensão é parecido com a vinculação de 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
Conceitos
Métodos de extensão (Visual Basic)
Referência
Propriedade do Indexador de Extensão
Propriedade Axis de atributo XML