XML-Value-Eigenschaft
Aktualisiert: November 2007
Stellt den Zugriff auf den Wert des ersten Elements einer Auflistung von XElement-Objekten bereit.
object.Value
Bestandteile
- object
Erforderlich. Auflistung von XElement-Objekten.
Rückgabewert
Ein String, der den Wert des ersten Elements der Auflistung enthält, bzw. bei einer leeren Auflistung Nothing.
Hinweise
Mit der Value-Eigenschaft erhalten Sie leicht Zugriff auf den Wert des ersten Elements in einer Auflistung von XElement-Objekten. Diese Eigenschaft überprüft zuerst, ob die Auflistung mindestens ein Objekt enthält. Wenn die Auflistung leer ist, gibt diese Eigenschaft Nothing zurück. Andernfalls gibt diese Eigenschaft den Wert der Value-Eigenschaft des ersten Elements der Auflistung zurück.
.gif "Hinweis") Hinweis: |
|---|
Wenn Sie mit dem '@'-Bezeichner auf den Wert eines XML-Attributs zugreifen, wird der Wert des Attributs als String zurückgegeben, und Sie müssen die Value-Eigenschaft nicht explizit angeben. |
Für den Zugriff auf andere Elemente in einer Auflistung können Sie die XML-Erweiterungsindexereigenschaft verwenden. Weitere Informationen finden Sie unter Erweiterungsindexereigenschaft.
Vererbung
Die meisten Benutzer müssen IEnumerable<T> nicht implementieren und können diesen Abschnitt daher ignorieren.
Die Value-Eigenschaft ist eine Erweiterungseigenschaft für Typen, die IEnumerable(Of XElement) implementieren. Die Bindung dieser Erweiterungseigenschaft entspricht der Bindung von Erweiterungsmethoden: Wenn ein Typ eine der Schnittstellen implementiert und eine Eigenschaft namens "Value" definiert, hat diese Eigenschaft Vorrang vor der Erweiterungseigenschaft. Anders ausgedrückt kann diese Value-Eigenschaft durch die Definition einer neuen Eigenschaft in einer Klasse, die IEnumerable(Of XElement) implementiert, überschrieben werden.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie mit der Value-Eigenschaft auf den ersten Knoten in einer Auflistung von XElement-Objekten zugegriffen werden kann. In diesem Beispiel wird mithilfe der untergeordneten Achseneigenschaft die Auflistung aller untergeordneten Knoten mit dem Namen phone abgerufen, die sich im contact-Objekt befinden.
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)
Durch diesen Code wird folgender Text angezeigt:
Phone number: 206-555-0144
Im folgenden Beispiel wird gezeigt, wie der Wert eines XML-Attributs aus einer Auflistung von XAttribute-Objekten abgerufen wird. In diesem Beispiel wird mithilfe der Attributachseneigenschaft der Wert des type-Attributs für alle phone-Elemente angezeigt.
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
Durch diesen Code wird folgender Text angezeigt:
home
work
Siehe auch
Konzepte
Erweiterungsmethoden (Visual Basic)
Referenz
Erweiterungsindexereigenschaft
Untergeordnete XML-Achseneigenschaft
XML-Attribut Achseneigenschaft