Propriété de valeur XML (Visual Basic)
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
