Vlastnost hodnoty XML (Visual Basic)

  • Článek

Poskytuje přístup k hodnotě prvního prvku kolekce XElement objektů.

Syntaxe

object.Value

Součástky

Pojem definice
object Povinný: XElement Kolekce objektů.

Návratová hodnota

A String , která obsahuje hodnotu prvního prvku kolekce, nebo Nothing pokud je kolekce prázdná.

Poznámky

Vlastnost Value usnadňuje přístup k hodnotě prvního prvku v kolekci XElement objektů. Tato vlastnost nejprve zkontroluje, zda kolekce obsahuje alespoň jeden objekt. Pokud je kolekce prázdná, vrátí tato vlastnost Nothing. V opačném případě tato vlastnost vrátí hodnotu Value vlastnosti prvního prvku v kolekci.

Poznámka:

Když přistupujete k hodnotě atributu XML pomocí identifikátoru @, vrátí se hodnota atributu String jako a není nutné explicitně zadat Value vlastnost.

Pro přístup k jiným prvkům v kolekci můžete použít vlastnost indexeru rozšíření XML. Další informace naleznete v tématu Extension Indexer Vlastnost.

Dědičnost

Většina uživatelů nebude muset implementovat IEnumerable<T>, a proto může ignorovat tuto část.

Vlastnost Value je vlastnost rozšíření pro typy, které implementují IEnumerable(Of XElement). Vazba této vlastnosti rozšíření je podobná vazbě rozšiřujících metod: pokud typ implementuje jedno z rozhraní a definuje vlastnost s názvem "Value", má tato vlastnost přednost před vlastností rozšíření. Jinými slovy, tuto Value vlastnost lze přepsat definováním nové vlastnosti ve třídě, která implementuje IEnumerable(Of XElement).

Příklad 1

Následující příklad ukazuje, jak použít Value vlastnost pro přístup k prvnímu uzlu v kolekci XElement objektů. Příklad používá podřízenou osu vlastnost získat kolekci všech podřízených uzlů pojmenovaných phone v objektu 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)

Tento kód zobrazí následující text:

Phone number: 206-555-0144

Příklad 2

Následující příklad ukazuje, jak získat hodnotu atributu XML z kolekce XAttribute objektů. Příklad používá vlastnost osy atributů k zobrazení hodnoty atributu type pro všechny phone prvky.

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

Tento kód zobrazí následující text:

home
work

Viz také