XML 值屬性 (Visual Basic) (部分機器翻譯)
可讓您存取 XElement 物件集合的第一個元素值。
語法
object.Value
組件
詞彙 | 定義 |
---|---|
object |
必要。 XElement 物件的集合。 |
傳回值
包含集合中第一個元素值的 String
;如果集合是空的,則為 Nothing
。
備註
Value 屬性可讓您輕鬆地存取 XElement 物件集合中第一個元素的值。 此屬性會先檢查集合是否至少包含一個物件。 如果集合是空的,則此屬性會傳回 Nothing
。 否則,此屬性會傳回集合中第一個元素的 Value 屬性值。
注意
當您使用 '@' 識別項存取 XML 屬性的值時,該屬性值會以 String
的形式傳回,而您不需要明確指定 Value 屬性。
若要存取集合中的其他項目,您可以使用 XML 延伸模組索引子屬性。 如需詳細資訊,請參閱延伸模組索引子屬性。
繼承
大部分的使用者都不需要實作 IEnumerable<T>,因此可以略過本節。
Value 屬性是實作 IEnumerable(Of XElement)
之類型的延伸模組屬性。 此延伸模組屬性的繫結類似於擴充方法的繫結:如果類型實作其中一個介面,並定義具有名稱 "Value" 的屬性,則該屬性的優先順序會高於延伸模組屬性。 換句話說,您可以在實作 IEnumerable(Of XElement)
的類別中定義新的屬性,來覆寫這個 Value 屬性。
範例 1
下列範例示範如何使用 Value 屬性來存取 XElement 物件集合中的第一個節點。 該範例使用子軸屬性來取得 contact
物件中名為 phone
的所有子節點集合。
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)
此程式碼顯示下列文字:
Phone number: 206-555-0144
範例 2
下列範例示範如何從 XAttribute 物件集合取得 XML 屬性的值。 該範例使用屬性 (Attribute) 軸屬性 (Property) 來顯示所有 phone
項目的 type
屬性 (Attribute) 值。
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
此程式碼顯示下列文字:
home
work