Proprietà Value XML (Visual Basic)
Fornisce l'accesso al valore del primo elemento di una raccolta di oggetti XElement.
Sintassi
object.Value
Parti
| Termine | Definizione |
|---|---|
object |
Obbligatorio. Raccolta di oggetti XElement. |
Valore restituito
String contenente il valore del primo elemento della raccolta, o Nothing se la raccolta è vuota.
Osservazioni:
La proprietà Value semplifica l'accesso al valore del primo elemento in una raccolta di oggetti XElement. Questa proprietà controlla innanzitutto se l'insieme contiene almeno un oggetto. Se l'insieme è vuoto, questa proprietà restituisce Nothing. In caso contrario, questa proprietà restituisce il valore della proprietà Value del primo elemento dell'insieme.
Nota
Quando si accede al valore di un attributo XML utilizzando l'identificatore '@', il valore dell'attributo viene restituito come String e non è necessario specificare in modo esplicito la proprietà Value.
Per accedere ad altri elementi in una raccolta, è possibile utilizzare la proprietà dell'indicizzatore di estensione XML. Per altre informazioni, vedere Proprietà dell'indicizzatore di estensioni.
Ereditarietà
La maggior parte degli utenti non dovrà implementare IEnumerable<T>, e può quindi ignorare questa sezione.
La proprietà Value è una proprietà di estensione per i tipi che implementano IEnumerable(Of XElement). L'associazione di questa proprietà di estensione è simile all'associazione dei metodi di estensione: se un tipo implementa una delle interfacce e definisce una proprietà con il nome "Value", tale proprietà ha la precedenza sulla proprietà di estensione. In altre parole, questa proprietà Value può essere sottoposta a override definendo una nuova proprietà in una classe che implementa IEnumerable(Of XElement).
Esempio 1
Nell'esempio seguente viene illustrato come utilizzare la proprietà Value per accedere al primo nodo in una raccolta di oggetti XElement. Nell'esempio viene utilizzata la proprietà asse figlio per ottenere la raccolta di tutti i nodi figlio denominati phone nell'oggetto 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)
Questo codice visualizza il testo seguente:
Phone number: 206-555-0144
Esempio 2
Nell'esempio seguente viene illustrato come ottenere il valore di un attributo XML da una raccolta di oggetti XAttribute. Nell'esempio viene utilizzata la proprietà axis dell'attributo per visualizzare il valore dell'attributo type per tutti gli elementi 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
Questo codice visualizza il testo seguente:
home
work
