Freigeben über

XML Value-Eigenschaft (Visual Basic)

Bietet 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

Eine String , die 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 zurück Nothing. Andernfalls gibt diese Eigenschaft den Wert der Value Eigenschaft des ersten Elements in der Auflistung zurück.

Hinweis

Wenn Sie mithilfe des Bezeichners "@" auf den Wert eines XML-Attributs zugreifen, wird der Attributwert als a String zurückgegeben, und Sie müssen die Value Eigenschaft nicht explizit angeben.

Um auf andere Elemente in einer Auflistung zuzugreifen, können Sie die XML-Erweiterungsindexereigenschaft verwenden. Weitere Informationen finden Sie unter Extension Indexer-Eigenschaft.

Vererbung

Die meisten Benutzer müssen sie nicht implementieren IEnumerable<T>und können daher diesen Abschnitt ignorieren.

Die Value Eigenschaft ist eine Erweiterungseigenschaft für Typen, die implementiert werden IEnumerable(Of XElement). Die Bindung dieser Erweiterungseigenschaft ähnelt der Bindung von Erweiterungsmethoden: Wenn ein Typ eine der Schnittstellen implementiert und eine Eigenschaft definiert, die den Namen "Value" hat, hat diese Eigenschaft Vorrang vor der Erweiterungseigenschaft. Mit anderen Worten, diese Value Eigenschaft kann überschrieben werden, indem eine neue Eigenschaft in einer Klasse definiert wird, die implementiert wird IEnumerable(Of XElement).

Beispiel 1

Das folgende Beispiel zeigt, wie Sie mit der Value Eigenschaft auf den ersten Knoten in einer Auflistung von XElement Objekten zugreifen. Im Beispiel wird die Untergeordnete Achseneigenschaft verwendet, um die Auflistung aller untergeordneten Knoten phone abzurufen, die contact sich im 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)

Dieser Code zeigt den folgenden Text an:

Phone number: 206-555-0144

Beispiel 2

Das folgende Beispiel zeigt, wie der Wert eines XML-Attributs aus einer Auflistung von XAttribute Objekten abgerufen wird. 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

Dieser Code zeigt den folgenden Text an:

home
work

Siehe auch

  • Last updated on