XML-érték tulajdonság (Visual Basic)
Hozzáférést biztosít az objektumgyűjtemény első elemének értékéhez XElement .
Syntax
object.Value
Részek
Időszak | Definíció |
---|---|
object |
Szükséges. Objektumok gyűjteménye XElement . |
Visszatérési érték
A String
gyűjtemény első elemének értékét tartalmazó érték, vagy Nothing
ha a gyűjtemény üres.
Megjegyzések
A Value tulajdonság megkönnyíti az objektumgyűjtemény első elemének XElement értékét. Ez a tulajdonság először ellenőrzi, hogy a gyűjtemény tartalmaz-e legalább egy objektumot. Ha a gyűjtemény üres, ez a tulajdonság ad vissza Nothing
. Ellenkező esetben ez a tulajdonság a gyűjtemény első elemének tulajdonságát Value adja vissza.
Feljegyzés
Ha egy XML-attribútum értékét a "@" azonosítóval éri el, az attribútum értékét a rendszer visszaadja String
, és nem kell explicit módon megadnia a Value tulajdonságot.
A gyűjtemény más elemeinek eléréséhez használhatja az XML-bővítmény indexelő tulajdonságát. További információ: Extension Indexer Tulajdonság.
Öröklődés
A legtöbb felhasználónak nem kell implementálnia IEnumerable<T>, ezért figyelmen kívül hagyhatja ezt a szakaszt.
A Value tulajdonság egy bővítménytulajdonság a megvalósító IEnumerable(Of XElement)
típusok számára. A bővítménytulajdonság kötése hasonló a bővítménymetelyek kötéséhez: ha egy típus implementálja az egyik illesztőt, és meghatároz egy "Value" nevű tulajdonságot, akkor a tulajdonság elsőbbséget élvez a bővítmény tulajdonságával szemben. Más szóval ezt a Value tulajdonságot felül lehet bírálni egy új tulajdonság definiálásával egy implementált IEnumerable(Of XElement)
osztályban.
1. példa
Az alábbi példa bemutatja, hogyan érheti el az objektumgyűjtemény első csomópontját XElement a Value tulajdonság használatával. A példa a gyermektengely tulajdonságot használja az objektumban contact
található phone
összes gyermekcsomópont gyűjteményének lekéréséhez.
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)
Ez a kód a következő szöveget jeleníti meg:
Phone number: 206-555-0144
2. példa
Az alábbi példa bemutatja, hogyan szerezheti be egy XML-attribútum értékét egy objektumgyűjteményből XAttribute . A példa az attribútumtengely tulajdonságával jeleníti meg az type
attribútum értékét az phone
összes elemhez.
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
Ez a kód a következő szöveget jeleníti meg:
home
work