Compartir a través de


Value (Propiedad XML) (Visual Basic)

Proporciona acceso al valor del primer elemento de una colección de objetos XElement.

object.Value

Partes

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, consulte Propiedad de indizador de extensión (Visual Basic).

Herencia

La mayoría de los usuarios no tendrán que implementar IEnumerable<T> 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

XElement

IEnumerable<T>

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)

Otros recursos

Propiedades de eje XML (Visual Basic)

Literales XML (Visual Basic)

Crear XML en Visual Basic