Partager via


Propriété de valeur XML (Visual Basic)

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

object.Value

Composants

Terme

Définition

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.

Notes

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 (Visual Basic).

Héritage

La plupart des utilisateurs n'ont pas besoin d'implémenter IEnumerableet 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

Référence

XElement

IEnumerable

Propriété d'indexeur d'extension (Visual Basic)

Propriété d'axe enfant XML (Visual Basic)

Propriété d'axe d'attribut XML (Visual Basic)

Concepts

Méthodes d'extension (Visual Basic)

Autres ressources

Propriétés d'axe XML (Visual Basic)

Littéraux XML (Visual Basic)

Création de code XML dans Visual Basic