Właściwość wartości XML (Visual Basic)
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
