Udostępnij za pośrednictwem

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

  • Artykuł

Zapewnia dostęp do wartości pierwszego elementu kolekcji XElement obiektów.

Składnia

object.Value

generatora

Termin Definicja
object Wymagany. XElement Kolekcja obiektów.

Wartość zwracana

Element String zawierający wartość pierwszego elementu kolekcji lub Nothing jeśli kolekcja jest pusta.

Uwagi

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

Uwaga

Gdy uzyskujesz dostęp do wartości atrybutu XML przy użyciu identyfikatora "@", wartość atrybutu jest zwracana jako a String i nie trzeba jawnie określać Value właściwości.

Aby uzyskać dostęp do innych elementów w kolekcji, możesz użyć właściwości indeksatora rozszerzeń XML. Aby uzyskać więcej informacji, zobacz Właściwość indeksatora rozszerzeń.

Dziedziczenie

Większość użytkowników nie będzie musiała implementować IEnumerable<T>elementu i dlatego może zignorować tę sekcję.

Właściwość Value jest właściwością rozszerzenia dla typów, które implementują IEnumerable(Of XElement)element . Powiązanie tej właściwości rozszerzenia jest podobne do powiązania metod rozszerzenia: jeśli typ implementuje jeden z interfejsów i definiuje właściwość o nazwie "Value", ta właściwość ma pierwszeństwo przed właściwością rozszerzenia. Innymi słowy, tę Value właściwość można zastąpić, definiując nową właściwość w klasie, która implementuje IEnumerable(Of XElement)element .

Przykład 1

W poniższym przykładzie pokazano, jak używać Value właściwości w celu uzyskania dostępu do pierwszego węzła w kolekcji XElement obiektów. W przykładzie użyto właściwości osi podrzędnej, aby pobrać kolekcję wszystkich węzłów podrzędnych o nazwie phone znajdującej contact się w obiekcie .

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

Przykład 2

W poniższym przykładzie pokazano, jak uzyskać wartość atrybutu XML z kolekcji XAttribute obiektów. W przykładzie użyto właściwości osi atrybutu, aby wyświetlić wartość atrybutu type dla wszystkich phone elementów.

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ż