Proprietà Value XML (Visual Basic)

Consente di accedere al valore del primo elemento di un insieme di oggetti XElement.

object.Value

Parti

Argomento

Definizione

object

Obbligatoria. Insieme di oggetti XElement.

Valore restituito

Oggetto String che contiene il valore del primo elemento dell'insieme, o Nothing se l'insieme è vuoto.

Note

La proprietà Value semplifica l'accesso al valore del primo elemento in un insieme di oggetti XElement. Questa proprietà dapprima controlla se l'insieme contiene almeno un oggetto. Se l'insieme è vuoto, questa proprietà restituisce Nothing. In caso contrario la 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 un oggetto String e non è necessario specificare in modo esplicito la proprietà Value.

Per accedere agli altri elementi in un insieme è possibile utilizzare la proprietà dell'indicizzatore di estensione XML. Per ulteriori informazioni, vedere Proprietà dell'indicizzatore di estensione (Visual Basic).

Ereditarietà

La maggior parte degli utenti non dovranno implementare IEnumerable<T>e possono pertanto 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 di metodi di estensione: se un tipo implementa una delle interfacce e definisce una proprietà che ha il nome "Valore", tale proprietà ha precedenza sulla proprietà di estensione. In altre parole, si può eseguire l'override di questa proprietà Value definendo una nuova proprietà in una classe che implementa IEnumerable(Of XElement).

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà Value per accedere al primo nodo di un insieme di oggetti XElement. Nell'esempio viene utilizzata la proprietà axis figlio per ottenere l'insieme di tutti i nodi figlio denominati phone inclusi 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)

Verrà visualizzato il seguente testo:

Phone number: 206-555-0144

Nell'esempio seguente viene illustrato come ottenere il valore di un attributo XML da un insieme di oggetti XAttribute. In questo esempio viene utilizzato l'attributo della proprietà axis per visualizzare il valore dell'attributo type per tutti gli elementi di 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

Verrà visualizzato il seguente testo:

home

work

Vedere anche

Riferimenti

XElement

IEnumerable<T>

Proprietà dell'indicizzatore di estensione (Visual Basic)

Proprietà Child Axis XML (Visual Basic)

Proprietà axis dell'attributo XML (Visual Basic)

Concetti

Metodi di estensione (Visual Basic)

Altre risorse

Proprietà Axis XML (Visual Basic)

Valori letterali XML (Visual Basic)

Creazione di XML in Visual Basic