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 属性的值。 该示例使用特性轴属性显示所有 phone 元素的 type 属性值。

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

另请参阅