Partager via

Propriété de valeur XML (Visual Basic)

  • Article

Fournit l’accès à la valeur du premier élément d’une collection d’objets XElement.

Syntaxe

object.Value

Éléments

Terme Définition
object Obligatoire. Collection d'objets XElement.

Valeur renvoyée

Un String qui contient la valeur du premier élément de la collection, ou Nothing si la collection est vide.

Notes

La propriété Value facilite l’accès à la valeur du premier élément d’une collection d’objets XElement. Cette propriété vérifie d’abord si la collection contient au moins un objet. Si la collection est vide, cette propriété retourne Nothing. Sinon, cette propriété retourne la valeur de la propriété Value du premier élément de la collection.

Notes

Lorsque vous accédez à la valeur d’un attribut XML à l’aide de l’identificateur « @ », la valeur de l’attribut est retournée en tant que String et vous n’avez pas besoin de spécifier explicitement la propriété Value.

Pour accéder à d’autres éléments d’une collection, vous pouvez utiliser la propriété d’indexeur d’extension XML. Pour plus d’informations, consultez Propriété d’extension Indexer.

Héritage

La plupart des utilisateurs n’auront pas à implémenter IEnumerable<T> et peuvent donc ignorer cette section.

La propriété Value est une propriété d’extension pour les types qui implémentent IEnumerable(Of XElement). La liaison de cette propriété d’extension est semblable à la liaison des méthodes d’extension : si un type implémente l’une des interfaces et définit une propriété portant le nom « Value », cette propriété a la priorité sur la propriété d’extension. En d’autres termes, cette propriété Value peut être substituée en définissant une nouvelle propriété dans une classe qui implémente IEnumerable(Of XElement).

Exemple 1

L’exemple suivant montre comment utiliser la propriété Value pour accéder au premier nœud d’une collection d’objets XElement. L’exemple utilise la propriété de l’axe enfant pour obtenir la collection de tous les nœuds enfants nommés phone qui se trouvent dans l’objet 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)

Ce code affiche le texte suivant :

Phone number: 206-555-0144

Exemple 2

L’exemple suivant montre comment obtenir la valeur d’un attribut XML à partir d’une collection d’objets XAttribute. L’exemple utilise la propriété de l’axe des attributs pour afficher la valeur de l’attribut type pour tous les éléments 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

Ce code affiche le texte suivant :

home
work

Voir aussi