XML 值属性

更新:2007 年 11 月

提供对 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 属性。

示例

下面的示例演示如何使用 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

下面的示例演示如何从 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

请参见

概念

扩展方法 (Visual Basic)

参考

XElement

IEnumerable<T>

扩展索引器属性

XML 子轴属性

XML 属性 (Attribute) 轴属性 (Property)

其他资源

XML 轴属性

XML 文本

在 Visual Basic 中创建 XML