Propriété de valeur XML
Mise à jour : novembre 2007
Fournit l'accès à la valeur du premier élément d'une collection d'objets XElement.
object.Value
Éléments
- object
Obligatoire. Collection d'objets XElement.
Valeur de retour
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 dans une collection d'objets XElement. Cette propriété vérifie tout d'abord si la collection contient au moins un objet. Si la collection est vide, cette propriété ne donne aucun résultat (Nothing). Dans le cas contraire, elle renvoie la valeur de la propriété Value du premier élément de la collection.
.gif "Remarque") Remarque : |
|---|
Lorsque vous accédez à la valeur d'un attribut XML à l'aide de l'identificateur @, la valeur de l'attribut est signalée en tant que String et vous n'avez pas besoin de spécifier la propriété Value explicitement. |
Pour accéder à d'autres éléments d'une collection, utilisez la propriété de l'indexeur d'extension XML. Pour plus d'informations, consultez Propriété d'indexeur d'extension.
Héritage
La plupart des utilisateurs n'ont pas besoin d'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 similaire à la liaison de méthodes d'extension : si un type implémente l'une des interfaces et définit une propriété portant le nom « Valeur », cette propriété a 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
L'exemple suivant indique comment utiliser la propriété Value pour accéder au premier nœud d'une collection d'objets XElement. Cet exemple utilise la propriété d'axe enfant pour obtenir la collection de tous les nœuds enfants nommés phone et se trouvant 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
L'exemple suivant indique comment obtenir la valeur d'un attribut XML à partir d'une collection d'objets XAttribute. L'exemple utilise la propriété de l'axe de l'attribut 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
Concepts
Méthodes d'extension (Visual Basic)
Référence
Propriété d'indexeur d'extension
Propriété d'axe d'attribut XML