Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Proporciona acceso al valor del primer elemento de una colección de XElement objetos .
Sintaxis
object.Value
Partes
| Término | Definición |
|---|---|
object |
Obligatorio. Colección de XElement objetos. |
Valor devuelto
que String contiene el valor del primer elemento de la colección o Nothing si la colección está vacía.
Observaciones
La Value propiedad facilita el acceso al valor del primer elemento de una colección de XElement objetos . 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 Value propiedad del primer elemento de la colección.
Nota:
Cuando se accede 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 Value propiedad.
Para acceder a otros elementos de una colección, puede usar la propiedad indexador de extensión XML. Para obtener más información, vea Propiedad del indexador de extensión.
Herencia
La mayoría de los usuarios no tendrán que implementar IEnumerable<T>y, por tanto, pueden omitir esta sección.
La Value propiedad 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 Value propiedad 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 Value propiedad para acceder al primer nodo de una colección de XElement objetos . 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 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 muestra el texto siguiente:
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 XAttribute objetos . En el ejemplo se usa la propiedad del eje de atributos para mostrar el valor del type atributo para todos los 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 muestra el texto siguiente:
home
work