XElement 类概述

更新:November 2007

XElement 类是 LINQ to XML 中的基础类之一。 它表示一个 XML 元素。 可以使用该类创建元素;更改元素内容;添加、更改或删除子元素;向元素中添加属性;或以文本格式序列化元素内容。 还可以与 System.Xml 中的其他类(例如 XmlReaderXmlWriterXslCompiledTransform)进行互操作。

XElement 功能

本主题描述 XElement 类提供的功能。

构造 XML 树

可以使用各种方式构造 XML 树,包括以下方式:

  • 可以在代码中构造 XML 树。 有关更多信息,请参见创建 XML 树

  • 可以从包括 TextReader、文本文件或 Web 地址 (URL) 在内的各种源解析 XML。 有关更多信息,请参见分析 XML

  • 可以使用 XmlReader 来填充树。 有关更多信息,请参见 ReadFrom

  • 如果您有一个可以将内容写入 XmlWriter 的模块,则可以使用 CreateWriter 方法来创建编写器,将该编写器传递到该模块,然后使用写入 XmlWriter 的内容来填充 XML 树。

但是,创建 XML 树的最常见的方法如下:

XElement contacts =
    new XElement("Contacts",
        new XElement("Contact",
            new XElement("Name", "Patrick Hines"), 
            new XElement("Phone", "206-555-0144"),
            new XElement("Address",
                new XElement("Street1", "123 Main St"),
                new XElement("City", "Mercer Island"),
                new XElement("State", "WA"),
                new XElement("Postal", "68042")
            )
        )
    );
Dim contacts As XElement = _
    <Contacts>
        <Contact>
            <Name>Patrick Hines</Name>
            <Phone>206-555-0144</Phone>
            <Address>
                <Street1>123 Main St</Street1>
                <City>Mercer Island</City>
                <State>WA</State>
                <Postal>68042</Postal>
            </Address>
        </Contact>
    </Contacts>

另一个创建 XML 树的十分常用的方法是使用 LINQ 查询的结果来填充 XML 树,如下面的示例所示:

XElement srcTree = new XElement("Root",
    new XElement("Element", 1),
    new XElement("Element", 2),
    new XElement("Element", 3),
    new XElement("Element", 4),
    new XElement("Element", 5)
);
XElement xmlTree = new XElement("Root",
    new XElement("Child", 1),
    new XElement("Child", 2),
    from el in srcTree.Elements()
    where (int)el > 2
    select el
);
Console.WriteLine(xmlTree);
Dim srcTree As XElement = _
    <Root>
        <Element>1</Element>
        <Element>2</Element>
        <Element>3</Element>
        <Element>4</Element>
        <Element>5</Element>
    </Root>
Dim xmlTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <%= From el In srcTree.Elements() _
            Where el.Value > 2 _
            Select el %>
    </Root>
Console.WriteLine(xmlTree)

此示例产生以下输出:

<Root>
  <Child>1</Child>
  <Child>2</Child>
  <Element>3</Element>
  <Element>4</Element>
  <Element>5</Element>
</Root>

序列化 XML 树

可以将 XML 树序列化为 FileTextWriterXmlWriter

有关更多信息,请参见序列化 XML 树

通过轴方法检索 XML 数据

可以使用轴方法检索属性、子元素、子代元素和上级元素。LINQ 查询对轴方法进行操作,并提供了多种灵活而有效的方法导航和处理 XML 树。

有关更多信息,请参见 LINQ to XML 轴

查询 XML 树

可以编写从 XML 树提取数据的 LINQ 查询。

有关更多信息,请参见查询 XML 树

修改 XML 树

可以通过各种方式修改元素,例如更改元素的内容或属性。 还可以从元素的父级移除元素。

有关更多信息,请参见修改 XML 树 (LINQ to XML)

请参见

概念

LINQ to XML 编程概述