LINQ之路20：LINQ to XML之Documents、Declarations和Namespaces

雨点打透心脏的1/2处 2022-01-10 16:59 248阅读 0赞

本篇我们会讨论与XML文档相关的另外几个重要概念：Documents、Declarations和Namespaces。一个XDocument封装了根元素并且允许我们添加XDeclaration, processing instructions, 文档类型和其他根级类型对象；一个标准的XML文件总是从一个declaration（声明）开始，它的作用是确保文件会被文件读取器正确的读取和理解；就像.NET类型可以有namespaces（命名空间）一样，XML元素和属性也可以有namespaces，用于对XML文档进行更有效的管理。

### XDocument ###

我们前面已经说过，一个XDocument封装了根元素并且允许我们添加XDeclaration, processing instructions, 文档类型和其他根级类型对象。和W3C DOM不同的是，对于LINQ to XML中的X-DOM来讲，一个XDocument对象是可选的，X-DOM并不需要它来把所有对象联系起来。

XDocument提供了和XElement一致的函数式构造器。并且由于XDocument是从Container继承而来，所以它也支持AddXXX、RemoveXXX、和ReplaceXXX方法。但和XElement不同的是，XDocument可以接受的内容是有限制的，它可以接受如下参数：

*  一个XElement对象（根元素）
 *  一个XDeclaration对象
 *  一个XDocumentType对象
 *  任意数量的XProcessingInstruction对象
 *  任意数量的XComment对象

要创建一个有效的XDocument，只有根元素是必须的。XDeclaration是可选的，如果它被省略，序列化时将会应用默认的设置。

一个最简单的XDocument仅有一个根元素：

var doc = new XDocument(
    new XElement("test", "data")
                          );

注意我们并没有包含XDeclaration对象，但是调用doc.Save方法生成的文件中还是会包含XML declaration信息，它会使用默认设置自动生成。

下面的示例用来生成一个简单但完全正确的XHTML文件，它很好的演示了XDocument可以接受的各种构造参数：

var styleInstruction = new XProcessingInstruction(
    "xml-stylesheet", "href='styles.css' type='text/css'");
    
    var docType = new XDocumentType("html",
    "-//W3C//DTD XHTML 1.0 Strict//EN",
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd", null);
    
                XNamespace ns = "http://www.w3.org/1999/xhtml";
    
    var root = new XElement(ns + "html",
    new XElement(ns + "head",
    new XElement(ns + "title", "An XHTML page")),
    new XElement(ns + "body",
    new XElement(ns + "p", "This is the content"))
                           );
    
    var doc = new XDocument(
    new XDeclaration("1.0", "utf-8", "no"),
    new XComment("Reference a stylesheet"),
                              styleInstruction,
                              docType,
                              root);
    
                doc.Save("D:\\test.html");

test.html文件的最终结果如下：

<?xml version="1.0" encoding="utf-8" standalone="no"?>
    
    
    <?xml-stylesheet href='styles.css' type='text/css'?>
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
    <title>An XHTML page</title>
    </head>
    <body>
    <p>This is the content</p>
    </body>
    </html>

XDocument的Root属性可以用来快速的存取其唯一的XElement元素。而XObject的Document属性则可以快速访问所在的XDocument对象，X-DOM tree里面的所有对象都继承了该属性：

Console.WriteLine(doc.Root.Name.LocalName);         // html
                XElement bodyNode = doc.Root.Element(ns + "body");
                Console.WriteLine(bodyNode.Document == doc);        // True

再次强调一下，document对象的子节点并没有Parent对象：

Console.WriteLine(doc.Root.Parent == null); // True
                foreach (XNode node in doc.Nodes())
                    Console.Write(node.Parent == null); // TrueTrueTrueTrue

### XML Declarations ###

一个标准的XML文件总是从一个declaration（声明）开始，如下所示：

<?xml version="1.0" encoding="utf-8" standalone="no"?>

XML declaration的作用是确保文件会被文件读取器正确的读取和理解。XElement和 XDocument会遵循以下规则来处理XML declarations：

*  提供一个文件名来调用Save方法时，总是写入declaration。
 *  提供XmlWriter来调用Save方法时，写入declaration，除非XmlWriter作了专门的指定。
 *  ToString方法从不产生XML declaration。

在构造XmlWriter对象时，我们可以通过设置OmitXmlDeclaration和ConformanceLevel属性来指示XmlWriter不要产生declaration。

XDeclaration对象的存在与否并不影响是否写入XML declaration。换句话说：即使没有XDeclaration对象，Save方法也会写入默认的declaration；相反，即使存在XDeclaration对象，ToString()方法也不会产生declaration。它的目的是告知XML serialization下面的信息：

*  使用什么字符编码（text encoding）
 *  如何设置XML declaration的encoding和standalone属性

XDeclaration的构造函数接受3个参数：version, encoding, 和standalone属性。下面的例子中，test.xml拥有UTF-16编码：

var doc = new XDocument(
    new XDeclaration("1.0", "utf-16", "yes"),
    new XElement("test", "data")
                          );
                doc.Save("test.xml");

实际上，XML writer会忽略第一个参数version值，而总是写入"1.0"。

### Names和Namespaces ###

就像.NET类型可以有namespaces（命名空间）一样，XML元素和属性也可以有namespaces。虽然我们在一般的小项目中可能不会用到namespaces，但是在产品级的软件中，我们就必须使用它来对各种XML文档进行管理了。

XML namespaces有两个作用，首先，和C\#的namespaces一样，它可以防止命名冲突。在我们把一个XML文件中的数据合并到另外一个XML文件时可能会出现。其次 ，它赋予一个Name（名称）以特别的含义。比如，名称”nil”可以表示任何东西。但是在[http://www.w3.org/2001/xmlschema-instance][http_www.w3.org_2001_xmlschema-instance]命名空间中，“nil”表示了C\#中的null语义。

因为XML命名空间非常容易引起混淆，我们将先行介绍该主题的普通含义，然后再讨论LINQ to XML对他们的使用方式。

#### XML中的Namespaces ####

假设我们希望在CNBlogs.LINQ命名空间中定义一个customer元素。那么有两种方法可以选择。第一种是使用xmlns属性，如下所示：

Xmlns是一个特殊的保留属性。上例中的xmlns有两个作用：

*  它为当前元素指定了一个命名空间。
 *  它为所有的后代节点指定了默认的命名空间。

这意味着下面的示例中，address和postcode会隐式位于CNBlogs.LINQ命名空间之中：

如果我们希望address和postcode不使用命名空间，我们需要明确指定，如下所示：

##### 前缀（Prefix） #####

指定命名空间的另一种方式是使用前缀。前缀是我们为命名空间指定的一个别名，目的是为了节省输入时间。

使用前缀分两步：定义前缀和使用前缀。我们可以按如下方式同时完成这两步操作：

<nut:customer xmlns:nut="CNBlogs.LINQ"/>

在上面的代码中会发生两件特别的事情。后面的xmlns:nut="..."定义了一个名为nut的前缀，这样该元素和所有的后代节点都可以使用该前缀了。前面的nut:customer把新创建的前缀赋给了customer元素。

和xmlns不同的是，带前缀的元素并没有为后代节点指定默认的命名空间，即前缀只作用于当前元素。下面的XML中，firstname的命名空间为空：

<nut:customer xmlns:nut="CNBlogs.LINQ">
    <firstname>Joe</firstname>
    </customer>

如要为firstname也指定CNBlogs.LINQ命名空间，我们得进行如下改写：

<nut:customer xmlns:nut="OReilly.Nutshell.CSharp">
    <nut:firstname>Joe</firstname>
    </customer>

当然，我们也可以为了后代节点定义一个或多个前缀，而不必在当前节点中使用它。下面的XML定义了两个前缀：i和z，但当前的customer元素命名空间保持为空：

如果customer是根节点，那么整个document都将拥有i和z命名空间。

当我们需要从多个命名空间中获取元素时，使用前缀就会非常方便，我们可以为每个命名空间定义一个前缀。

#### 在X-DOM中指定Namespaces ####

到目前为止，我们只为XElement和XAttribute使用了简单的名字（一个简单的字符串）。它表示该XML name位于空的命名空间中，就像.NET全局命名空间中的类型一样。

有数种方式可以在X-DOM中指定命名空间。第一种是在名称之前的大括号中指定，如下所示：

var e = new XElement ("{http://www.cnblogs.com/xmlspace}customer", "LifePoem");
                Console.WriteLine (e.ToString());
    
    //产生的XML如下:
                <customer xmlns="http://www.cnblogs.com/xmlspace">LifePoem</customer>

第二张（更有效率）的方式是使用XNamespace和XName类型。下面是他们的定义：

public sealed class XNamespace
        {
        
    public string NamespaceName { get; }
        }
    public sealed class XName // 一个本地名称和一个可选的namespace
        {
        
    public string LocalName { get; }
    public XNamespace Namespace { get; } // 可选
        }

这两个类型都定义了来自string的隐式转换，所以下面的代码是正确的：

XNamespace ns = "http://www.cnblogs.com/xmlspace";
                XName localName = "customer";
                XName fullName = "{http://www.cnblogs.com/xmlspace}customer";

XName还重载了+运算符，这允许我们不使用大括号来组合namespace和name：

XNamespace ns = "http://www.cnblogs.com/xmlspace";
                XName fullName = ns + "customer";
                Console.WriteLine(fullName); // {
         http://www.cnblogs.com/xmlspace}customer

实际上，X-DOM中所有接受元素或属性名称的的构造函数和方法，其参数类型为XName而不是string。在我们前面的例子中可以使用string的原因是隐式转换。

不管是元素还是属性，指定命名空间的方式都是一样的：

XNamespace ns = "http://domain.com/xmlspace";
    var data = new XElement(ns + "data",
    new XAttribute(ns + "id", 123)
                );

#### X-DOM和默认命名空间 ####

在X-DOM的创建过程中它会忽略默认命名空间的概念，直到真正输出XML时才会使用默认命名空间。这意味着，我们在创建子元素时，我们必须显示指定必须的命名空间，它不会从父节点继承：

XNamespace ns = "http://www.cnblogs.com/xmlspace";
    var data = new XElement(ns + "data",
    new XElement(ns + "customer", "Bloggs"),
    new XElement(ns + "purchase", "Bicycle")
                           );
                Console.WriteLine(data.ToString());

但是，当X-DOM读取或输出XML时，它会应用默认的命名空间，所以上面的代码输出如下：

<data xmlns="http://www.cnblogs.com/xmlspace">
    <customer>Bloggs</customer>
    <purchase>Bicycle</purchase>
    </data>

下面的代码：

Console.WriteLine (data.Element (ns + "customer").ToString());
                // 输出单个元素时会加上默认的命名空间：
    <customer xmlns="http://www.cnblogs.com/xmlspace">Bloggs</customer>

如果我们在创建子XElement时没有指定命名空间，那么他们的命名空间为空，如下所示：

XNamespace ns = "http://www.cnblogs.com/xmlspace";
    var data = new XElement(ns + "data",
    new XElement("customer", "Bloggs"),
    new XElement("purchase", "Bicycle")
                           );
                Console.WriteLine(data.ToString());

我们会得到如下结果：

<data xmlns="http://www.cnblogs.com/xmlspace">
    <customer xmlns="">Bloggs</customer>
    <purchase xmlns="">Bicycle</purchase>
    </data>

另外一个可能的陷阱是我们在导航X-DOM时没有加上适当的命名空间：

如果我们在创建X-DOM tree时没有指定命名空间，我们可以通过如下代码为所有元素指定一个命名空间：

foreach (XElement e in data.DescendantsAndSelf())
    if (e.Name.Namespace == "")
                        e.Name = ns + e.Name.LocalName;

#### 前缀/Prefixes ####

X-DOM只是把前缀作为序列化功能来使用，这意味着我们可以选择完全忽略前缀问题。唯一的例外是当我们在输出一个XML文件时为了取得更好的效率。比如，考虑下面的代码：

XNamespace ns1 = "http://www.cnblogs.com/space1";
                XNamespace ns2 = "http://www.cnblogs.com/space2";
    var mix = new XElement(ns1 + "data",
    new XElement(ns2 + "element", "value"),
    new XElement(ns2 + "element", "value"),
    new XElement(ns2 + "element", "value")
                );

默认情况下，XElement会被序列化为如下格式：

<data xmlns="http://www.cnblogs.com/space1">
    <element xmlns="http://www.cnblogs.com/space2">value</element>
    <element xmlns="http://www.cnblogs.com/space2">value</element>
    <element xmlns="http://www.cnblogs.com/space2">value</element>
    </data>

正如你所看到的，这里有一些没有必要的重复。解决方案不是改变创建X-DOM的方式，而是给序列化器一个暗示，用前缀来简化相关的命名空间。这可以通过添加定义前缀的属性来完成，并且通常由根元素来完成：

mix.SetAttributeValue(XNamespace.Xmlns + "ns1", ns1);
                mix.SetAttributeValue(XNamespace.Xmlns + "ns2", ns2);

这会把前缀 “ns1”赋给XNamespace变量ns1，“ns2”赋给ns2。这样X-DOM在序列化时会自动使用这些属性来简化最终的XML。下面是在mix上调用ToString方法的最终结果：

<ns1:data xmlns:ns1="http://domain.com/space1"
    xmlns:ns2="http://domain.com/space2">
    <ns2:element>value</ns2:element>
    <ns2:element>value</ns2:element>
    <ns2:element>value</ns2:element>
    </ns1:data>

使用前缀并不改变我们创建、查询或更新X-DOM的方式，所以我们就好像前缀不存在一样继续在程序中使用全名。只有在从XML文件/流中读取或写入时才会使用前缀。

下一篇也是LINQ to XML的最后一篇，我们将会和大家讨论使用LINQ to XML来生成X-DOM的方式。

--------------------

**系列博客导航：**

**[LINQ之路系列博客导航][LINQ]**

[LINQ之路 1：LINQ介绍][LINQ_1_LINQ]

[LINQ之路 2：C\# 3.0的语言功能（上）][LINQ_2_C_ 3.0]

[LINQ之路 3：C\# 3.0的语言功能（下）][LINQ_3_C_ 3.0]

[LINQ之路 4：LINQ方法语法][LINQ_ 4_LINQ]

[LINQ之路 5：LINQ查询表达式][LINQ_ 5_LINQ]

[LINQ之路 6：延迟执行(Deferred Execution)][LINQ_ 6_Deferred Execution]

[LINQ之路 7：子查询、创建策略和数据转换][LINQ_ 7]

[LINQ之路 8：解释查询（Interpreted Queries）][LINQ_ 8_Interpreted Queries]

[LINQ之路 9：LINQ to SQL 和 Entity Framework（上）][LINQ_ 9_LINQ to SQL _ Entity Framework]

[LINQ之路10：LINQ to SQL 和 Entity Framework（下）][LINQ_10_LINQ to SQL _ Entity Framework]

[LINQ之路11：LINQ Operators之过滤(Filtering)][LINQ_11_LINQ Operators_Filtering]

[LINQ之路12：LINQ Operators之数据转换(Projecting)][LINQ_12_LINQ Operators_Projecting]

[LINQ之路13：LINQ Operators之连接(Joining)][LINQ_13_LINQ Operators_Joining]

[LINQ之路14：LINQ Operators之排序和分组(Ordering and Grouping)][LINQ_14_LINQ Operators_Ordering and Grouping]

[LINQ之路15：LINQ Operators之元素运算符、集合方法、量词方法][LINQ_15_LINQ Operators]

[LINQ之路16：LINQ Operators之集合运算符、Zip操作符、转换方法、生成器方法][LINQ_16_LINQ Operators_Zip]

[LINQ之路17：LINQ to XML之X-DOM介绍][LINQ_17_LINQ to XML_X-DOM]

[LINQ之路18：LINQ to XML之导航和查询][LINQ_18_LINQ to XML]

[LINQ之路19：LINQ to XML之X-DOM更新、和Value属性交互][LINQ_19_LINQ to XML_X-DOM_Value]

[LINQ之路20：LINQ to XML之Documents、Declarations和Namespaces][LINQ_20_LINQ to XML_Documents_Declarations_Namespaces]

[LINQ之路21：LINQ to XML之生成X-DOM（Projecting）][LINQ_21_LINQ to XML_X-DOM_Projecting]

[LINQ之路系列博客后记][LINQ 1]

转载于:https://www.cnblogs.com/lifepoem/archive/2011/12/12/2285092.html

[http_www.w3.org_2001_xmlschema-instance]: http://www.w3.org/2001/xmlschema-instance
[LINQ]: http://www.cnblogs.com/lifepoem/archive/2011/12/16/2288017.html
[LINQ_1_LINQ]: http://www.cnblogs.com/lifepoem/archive/2011/10/25/2223765.html
[LINQ_2_C_ 3.0]: http://www.cnblogs.com/lifepoem/archive/2011/10/26/2225054.html
[LINQ_3_C_ 3.0]: http://www.cnblogs.com/lifepoem/archive/2011/10/26/2225086.html
[LINQ_ 4_LINQ]: http://www.cnblogs.com/lifepoem/archive/2011/10/27/2226556.html
[LINQ_ 5_LINQ]: http://www.cnblogs.com/lifepoem/archive/2011/10/28/2227735.html
[LINQ_ 6_Deferred Execution]: http://www.cnblogs.com/lifepoem/archive/2011/10/29/2228589.html
[LINQ_ 7]: http://www.cnblogs.com/lifepoem/archive/2011/10/31/2230175.html
[LINQ_ 8_Interpreted Queries]: http://www.cnblogs.com/lifepoem/archive/2011/11/07/2238978.html
[LINQ_ 9_LINQ to SQL _ Entity Framework]: http://www.cnblogs.com/lifepoem/archive/2011/11/10/2244386.html
[LINQ_10_LINQ to SQL _ Entity Framework]: http://www.cnblogs.com/lifepoem/archive/2011/11/15/2249303.html
[LINQ_11_LINQ Operators_Filtering]: http://www.cnblogs.com/lifepoem/archive/2011/11/16/2250676.html
[LINQ_12_LINQ Operators_Projecting]: http://www.cnblogs.com/lifepoem/archive/2011/11/18/2253579.html
[LINQ_13_LINQ Operators_Joining]: http://www.cnblogs.com/lifepoem/archive/2011/11/22/2258830.html
[LINQ_14_LINQ Operators_Ordering and Grouping]: http://www.cnblogs.com/lifepoem/archive/2011/11/25/2262646.html
[LINQ_15_LINQ Operators]: http://www.cnblogs.com/lifepoem/archive/2011/11/28/2265837.html
[LINQ_16_LINQ Operators_Zip]: http://www.cnblogs.com/lifepoem/archive/2011/11/29/2267243.html
[LINQ_17_LINQ to XML_X-DOM]: http://www.cnblogs.com/lifepoem/archive/2011/12/06/2277554.html
[LINQ_18_LINQ to XML]: http://www.cnblogs.com/lifepoem/archive/2011/12/07/2278787.html
[LINQ_19_LINQ to XML_X-DOM_Value]: http://www.cnblogs.com/lifepoem/archive/2011/12/09/2281577.html
[LINQ_20_LINQ to XML_Documents_Declarations_Namespaces]: http://www.cnblogs.com/lifepoem/archive/2011/12/12/2285092.html
[LINQ_21_LINQ to XML_X-DOM_Projecting]: http://www.cnblogs.com/lifepoem/archive/2011/12/13/2285780.html
[LINQ 1]: http://www.cnblogs.com/lifepoem/archive/2011/12/14/2287303.html