Value (Propiedad XML) (Visual Basic)
Proporciona acceso al valor del primer elemento de una colección de objetos XElement.
object.Value
Elementos
Término |
Definición |
object |
Obligatorio. 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 en una colección de objetos XElement. Esta propiedad comprueba primero si la colección contiene por lo menos un objeto. Si la colección está vacía, esta propiedad devuelve Nothing. De lo contrario, devuelve el valor de la propiedad Value del primer elemento de la colección.
Nota
Al obtener acceso al valor de un atributo XML mediante el identificador '@', el valor del atributo se devuelve como String y no se necesita especificar explícitamente la propiedad Value.
Para obtener acceso a los otros elementos de una colección, puede usar la propiedad de los indizadores en las extensiones XML. Para obtener más información, vea Propiedad de indizador de extensión (Visual Basic).
Herencia
La mayoría de los usuarios no tendrán que implementar IEnumerable y, por consiguiente, podrán omitir esta sección.
La propiedad Value es una propiedad de extensión de los tipos que implementan IEnumerable(Of XElement). El enlace de esta propiedad de extensión es como el enlace de los métodos de extensión: si un tipo implementa una de las interfaces y define una propiedad denominada "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 implemente IEnumerable(Of XElement).
Ejemplo
En el ejemplo siguiente se muestra cómo usar la propiedad Value para obtener acceso al primer nodo en una colección de objetos XElement. En el ejemplo se usa la propiedad de eje secundario para obtener la colección de todos los nodos secundarios denominados phone que se encuentran 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 texto siguiente:
Phone number: 206-555-0144
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 de eje de atributo para mostrar el valor del atributo type de 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 texto siguiente:
home
work
Vea también
Referencia
Propiedad de indizador de extensión (Visual Basic)
Propiedades de eje secundario XML (Visual Basic)
Propiedad de eje para atributos XML (Visual Basic)
Conceptos
Métodos de extensión (Visual Basic)