Value (Propiedad XML) (Visual Basic)
Proporciona acceso al valor del primer elemento de una colección de objetos XElement.
Sintaxis
object.Value
Partes
| Término | Definición |
|---|---|
object |
Obligatorio. Una colección de objetos XElement. |
Valor devuelto
String que contiene el valor del primer elemento de la colección, o Nothing si la colección está vacía.
Comentarios
La propiedad Value facilita el acceso al valor del primer elemento de una colección de objetos XElement. Esta propiedad comprueba primero si la colección contiene al menos un objeto. Si la colección está vacía, esta propiedad devuelve Nothing. De lo contrario, esta propiedad devuelve el valor de la propiedad Value del primer elemento de la colección.
Nota
Cuando se obtiene acceso al valor de un atributo XML mediante el identificador '@', el valor del atributo se devuelve como String y no es necesario especificar explícitamente la propiedad Value.
Para tener acceso a otros elementos de una colección, puede usar la propiedad del indexador de extensión XML. Para obtener más información, consulte Propiedad de indexador de extensión.
Herencia
La mayoría de los usuarios no tendrán que implementar IEnumerable<T> y, por lo tanto, pueden omitir esta sección.
La propiedad Value es una propiedad de extensión para los tipos que implementan IEnumerable(Of XElement). El enlace de esta propiedad de extensión es similar al enlace de métodos de extensión: si un tipo implementa una de las interfaces y define una propiedad que tiene el nombre "Value", esa propiedad tiene prioridad sobre la propiedad de extensión. En otras palabras, esta propiedad Value se puede invalidar definiendo una nueva propiedad en una clase que implementa IEnumerable(Of XElement).
Ejemplo 1
En el ejemplo siguiente se muestra cómo usar la propiedad Value para tener acceso al primer nodo de una colección de objetos XElement. En el ejemplo se usa la propiedad del eje secundario para obtener la colección de todos los nodos secundarios denominados phone que están en el 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 muestra el siguiente texto:
Phone number: 206-555-0144
Ejemplo 2
En el ejemplo siguiente se muestra cómo obtener el valor de un atributo XML de una colección de objetos XAttribute. En el ejemplo se usa la propiedad del eje de atributos para mostrar el valor del atributo type para todos los 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 muestra el siguiente texto:
home
work
