XML Value, propriété (Visual Basic)

2025-07-31

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

Syntaxe

object.Value

Pièces

Terme	Définition
`object`	Obligatoire. Collection d’objets XElement .

Valeur de retour

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

Remarques

La Value propriété 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 Value propriété du premier élément de la collection.

Remarque

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 valeur et vous n’avez pas besoin de spécifier explicitement la Value propriété.

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 La propriété De l’indexeur d’extension.

Héritage

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

La Value propriété 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 Value propriété 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 Value propriété 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 phone éléments.

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

Partager via