xmltextwriter类
用在本节中的方法创建xml文档显然并不困难。多年以来,开发者都是通过在缓存在连接一些字符串,连接好以后再把缓存中字符串输出到文件的方式来创建xml文档。但是以这种方式创建xml文档的方法只有在你保证字符串中不存在任何细小的错误的时候才有效。.net framework通过用xmlwriter提供了更好的创建xml文档的方法。
xml writer类以只前(forward-only)的方式输出xml数据到流或者文件中。更重要的是,xml writer在设计时就保证所有的xml数据都符合w3c xml 1.0推荐规范,你甚至不用担心忘记写闭标签,因为xml writer会帮你写。xmlwriter是所有 xml writer的抽象基类。.net framework只提供唯一的一个writer 类----xmltextwriter类。
我们先来看看xml writers和旧的writers的不同点,下面的代码保存了一个string型的数组:
stringbuilder sb = new stringbuilder("");
sb.append("
foreach(string s in thearray) {
sb.append("
sb.append(s);
sb.append("\"/>");
}
sb.append("
代码通过循环取出数据中的元素,写好标签文本并把它们累加到一个string中。代码保证输出的内容是格式良好的并且注意了新行的缩进,及支持命名空间。当创建的文档结构比较简单时,这种方法可能不会有错误。然而,当你要支持处理指令,命名空间,缩进,格式化以及实体的时候,代码的数量就成指数级增长,出错的可能性也随之增长。
xml writer写方法功能对应每个可能的xml节点类型,它使创建xml文档的过程更符合逻辑、更少的信赖于繁琐的标记语言。图六演示了怎么样用xmltextwriter类的方法来连接一个string数据。代码很简洁,用xml writer的代码更容易读、结构更好。
figure 6 serializing a string array
void createxmlfileusingwriters(string[] thearray, string filename)
{
/ open the xml writer (用默认的字符集)
xmltextwriter xmlw = new xmltextwriter(filename, null);
xmlw.formatting = formatting.indented;
xmlw.writestartdocument();
xmlw.writestartelement("array");
foreach(string s in thearray)
{
xmlw.writestartelement("element");
xmlw.writeattributestring("&#118alue", s);
xmlw.writeendelement();
}
xmlw.writeenddocument();
/ close the writer
xmlw.close();
}
然而xml writer并不是魔术师----它不能修复输入的错误。xml writer不会检查元素名和属性名是否有效,也不保证被用的任何的unicode字符集适合当前架构的编码集。如上所述,为了避免输出错误,必须要杜绝非xml字符。但是writer没有提供这种方法。
另外,当创建一个属性节点时,writer不会检验属性节点的名称是否与已存在的元素节点的名称相同。最后,xmlwriter类不是一个带验证的writer类,也不保证输出是否符合schema或者dtd。在.net framework中带验证的writer类目前来说还没有提供。但是在我写的《applied xml programming for microsoft .net (microsoft press!reg;, 2002)》书中,我自己写了一个带验证的writer组件。你可以到下面的网址去下载源码:http://www.microsoft.com/mspress/books/6235.asp.
图七列出了xml writer的一些状态值(state)。这些值都源于writestate枚举类。当你创建一个writer,它的初始状态为start,表示你将要配置该对象,实际上writer没有开始。下一个状态是prolog,该状态是当你调用writestartdocument方法开始工作的时候设置的。然后,状态的转换就取决于你的写的文档及文档的内容了。prolog状态一直保留到当你增加一个非元素节点时,例如注释元素,处理指令及文档类型。当第一个节点也就是根节点写完后,状态就变为element。当你调用writerstartatribute方法时状态转换为attribute,而不是当你调用writeatributestring方法写属性时转换为该状态。如果那样的话,状态应该是element。当你写一个闭标签(>)时,状态会转换成content。当你写完文档后,调用writeenddocument方法,状态就会返回为start,直到你开始写另一个文档或者把writer关掉。