实例化一个X-DOM

不使用Load或者Parse方法, 你还可以通过调用XContainer的Add方法手工实例化对象创建一棵X-DOM树

为了创建一个XElement和XAttribute, 你只需要提供一个名称和对应值

   1: XElement lastName = new XElement ("lastname", "Bloggs");

   2: lastName.Add (new XComment ("nice name"));

   3:

   4: XElement customer = new XElement ("customer");

   5: customer.Add (new XAttribute ("id", 123));

   6: customer.Add (new XElement ("firstname", "Joe"));

   7: customer.Add (lastName);

   8:

   9: Console.WriteLine (customer.ToString());

输出结果为:

   1: <customer id="123">

   2:   <firstname>Joe</firstname>

   3:   <lastname>Bloggs<!--nice name--></lastname>;

   4: </customer>

当构建一个XElement的时候, 一个value是可选的–你可以只提供元素名之后再添加内容. 注意当你确实提供了一个value的时候, 并不需要显式创建并增加一个XText的子节点. X-DOM会自动帮我们完成这项工作, 因此你可以简单地处理value字符串.

函数式构建

在之前的例子中, 我们通过代码很难收集到整个XML的结构. X-DOM支持另外一种实例化的模式, 称为函数式构建(来源于函数式编程). 使用函数式构建, 我们可以使用一个单一的表达式创建整棵树:

   1: XElement customer =

   2:   new XElement ("customer", new XAttribute("id", 123),

   3:     new XElement ("firstname","joe"),

   4:     new XElement ("lastname","bloggs",

   5:       new XComment ("nice name")

   6:     )

   7:   );

这会带来两个好处, 首先, 代码与整个XML的结构非常相似, 其次, 可以和LINQ查询集成. 例如, 可以通过下面的LINQ to SQL查询将结构直接输出为一个X-DOM:

   1: XElement query =

   2:   new XElement ("customers",

   3:     from c in dataContext.Customers

   4:     select

   5:       new XElement ("customer",

   6:         new XAttribute("id", c.ID),

   7:         new XElement ("firstname", c.FirstName),

   8:         new XElement ("lastname", c.LastName,

   9:           new XComment ("nice name")

  10:         )

  11:       )

  12:   );

指定内容

函数式构建是可能的, 因为XElement(以及XDocument)的构造器都是重载并可接受一个params的对象数组

   1: public XElement (XName name, params object[] content)

XContainer的Add方法也类似:

   1: public void Add (params object[] content)

因此当创建或者添加一个X-DOM的时候你可以指定任意数量, 任意类型的子对象, 这是没有任何问题的因为所有的事物都被认为是合法的内容. 要了解为什么, 我们了解一下每一个内容对象在内部是如何被处理的. 以下这些是XContainer所作的决定, 按顺序:

1. 如果对象是null, 它将被忽略
2. 如果对象是基于XNode或者XStreamingElement, 它将被加入到Nodes集合当中
3. 如果对象是一个XAttribute, 它将被加入到Attributes集合当中
4. 如果对象是一个字符串, 它将被包装为XNode节点并被加入到Nodes中
5. 如果对象实现了IEnumerable, 它将被枚举并且相同的规则会被用于每一个元素
6. 否则, 对象将被转换为一个string, 包装成一个XText节点, 然后加入到Nodes中

所有的对象最终归结到两个单元中: Nodes和Attributes. 此外, 任何的对象都是有效的内容因为它可以调用ToString并最终被包装成为一个XText节点.

在调用任何类型的ToString之前, XContainer首先测试它是否是以下类型的其中一种:

float, double, decimal, bool, DateTime, DateTimeOffset, TimeSpan

如果是, 它会再次调用XmlConvert这个帮助类上面对应的ToString而不是对象本身的ToString方法. 这可以确保数据是round-trippable并且符合标准XML格式要求

自动深度克隆

当一个节点或者属性(attribute)被加入到一个元素当中(不论是通过函数式构建还是通过调用Add方法), 该节点或者属性的Parent属性(property)被设置为该元素. 一个节点只能拥有一个父元素; 如果你将一个已经拥有父节点的节点加入到第二个父节点当中, 该节点将会被自动深度克隆. 这个自动复制让X-DOM对象实例化免于边界的影响–这也是函数式编程的另外一个印记.

待续!