Udostępnij za pośrednictwem


Właściwość wartość XML (Visual Basic)

Zapewnia dostęp do wartości pierwszy element z kolekcji XElement obiektów.

object.Value

Części

Termin

Definicja

object

Wymagane.Kolekcja XElement obiektów.

Wartość zwracana

A String zawierający wartość pierwszego elementu kolekcji, lub Nothing Jeśli zbiór jest pusty.

Uwagi

Value Właściwość ułatwia dostęp wartość pierwszego elementu w kolekcji z XElement obiektów.Właściwość ta najpierw sprawdza, czy kolekcji zawiera co najmniej jeden obiekt.Jeśli kolekcja jest puste, właściwość ta zwraca Nothing.W przeciwnym razie, właściwość ta zwraca wartość Value właściwość pierwszy element w kolekcji.

[!UWAGA]

Kiedy dostęp jest wartość atrybutu XML przy użyciu identyfikatora '@', wartość atrybutu jest zwracana jako String i nie trzeba jawnie określić Value właściwości.

Aby uzyskać dostęp do innych elementów w kolekcji, można użyć właściwości indeksowania rozszerzenia XML.Aby uzyskać więcej informacji, zobacz Właściwość indeksująca rozszerzenie (Visual Basic).

Dziedziczenie

Większość użytkowników nie trzeba implementować IEnumerable<T>i dlatego można zignorować w tej sekcji.

Value Właściwości jest właściwość extension dla typów, które implementują IEnumerable(Of XElement).Powiązanie to właściwość extension jest jak powiązanie rozszerzenia metody: Jeśli typu implementuje jednego z interfejsów i określa właściwość, która ma nazwę "Wartość", że właściwość ma pierwszeństwo przed Właściwość extension.Innymi słowy, to Value właściwość może być zastąpiona przez definiowanie nowych właściwości klasy, który implementuje IEnumerable(Of XElement).

Przykład

Poniższy przykład pokazuje, jak używać Value właściwość pierwszego węzła w kolekcji z dostępu do XElement obiektów.W przykładzie użyto właściwości osi podrzędnej pobrać kolekcji wszystkie węzły podrzędne o nazwie phone w contact obiektu.

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)

Ten kod wyświetla następujący tekst:

Phone number: 206-555-0144

Poniższy przykład ilustruje sposób uzyskać wartość atrybutu XML z kolekcji XAttribute obiektów.W przykładzie użyto właściwości osi atrybutu, aby wyświetlić wartości z type atrybutu dla wszystkich phone elementy.

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

Ten kod wyświetla następujący tekst:

home

work

Zobacz też

Informacje

XElement

IEnumerable<T>

Właściwość indeksująca rozszerzenie (Visual Basic)

Właściwość osi podrzędnej XML (Visual Basic)

Właściwość osi atrybut XML (Visual Basic)

Koncepcje

Rozszerzenie metody (Visual Basic)

Inne zasoby

Właściwości osi XML (Visual Basic)

Literały XML (Visual Basic)

Tworzenie XML w języku Visual Basic