XML-Value-Eigenschaft (Visual Basic)
Ermöglicht den Zugriff auf den Wert des ersten Elements einer Auflistung von XElement -Objekten.
Syntax
object.Value
Bestandteile
| Begriff | Definition |
|---|---|
object |
Erforderlich. Auflistung von XElement-Objekten. |
Rückgabewert
Ein String, der den Wert des ersten Elements der Auflistung enthält, oder Nothing, wenn die Auflistung leer ist.
Bemerkungen
Die Value-Eigenschaft erleichtert den Zugriff auf den Wert des ersten Elements in einer Auflistung von XElement-Objekten. Diese Eigenschaft überprüft zunächst, 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 in der Auflistung zurück.
Hinweis
Wenn Sie mit dem Bezeichner „@“ auf den Wert eines XML-Attributs zugreifen, wird der Attributwert als String zurückgegeben und Sie müssen die Eigenschaft Value nicht explizit angeben.
Um auf andere Elemente in einer Auflistung zuzugreifen, können Sie die Indexereigenschaft der XML-Erweiterung verwenden. Weitere Informationen finden Sie unter Erweiterungsmethoden.
Vererbung
Die meisten Benutzer müssen nicht implementieren IEnumerable<T>und können daher diesen Abschnitt ignorieren.
Die Value-Eigenschaft ist eine Erweiterungseigenschaft für Typen, die IEnumerable(Of XElement) implementieren. Die Bindung dieser Erweiterungseigenschaft ähnelt der Bindung von Erweiterungsmethoden: Wenn ein Typ eine der Schnittstellen implementiert und eine Eigenschaft mit dem Namen „Value“ definiert, hat diese Eigenschaft Vorrang vor der Erweiterungseigenschaft. Anders ausgedrückt: Diese Value-Eigenschaft kann überschrieben werden, indem eine neue Eigenschaft in einer Klasse definiert wird, die IEnumerable(Of XElement) implementiert.
Beispiel 1
Im folgenden Beispiel wird gezeigt, wie die Value-Eigenschaft verwendet wird, um auf den ersten Knoten in einer Auflistung von XElement-Objekten zuzugreifen. Im Beispiel wird die untergeordnete Achseneigenschaft verwendet, um die Auflistung aller untergeordneten Knoten namens phone abzurufen, 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
Beispiel 2
Das folgende Beispiel zeigt, wie Sie den Wert eines XML-Attributs aus einer Auflistung von XAttribute-Objekten abrufen. Im Beispiel wird die Attributachseneigenschaft verwendet, um den Wert des type-Attributs für alle phone-Elemente anzuzeigen.
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
