ASP.NET XmlDocument类详解

491 查看

XmlDocument类是.NET框架的DOC解析器。XmlDocument将XML视为树状结构,它装载XML文档,并在内存中构建该文档的树状结构。下面来看下XmlDocument提供了哪些功能。

一、属性:

Attributes      获取一个 XmlAttributeCollection,它包含该节点的属性。 (继承自 XmlNode。)
BaseURI          获取当前节点的基 URI。 (重写 XmlNode..::.BaseURI。)
ChildNodes      获取节点的所有子节点。 (继承自 XmlNode。)
DocumentElement   获取文档的根 XmlElement。
DocumentType    获取包含 DOCTYPE 声明的节点。
FirstChild       获取节点的第一个子级。 (继承自 XmlNode。)
HasChildNodes     获取一个值,该值指示节点是否有任何子节点。 (继承自 XmlNode。)
Implementation     获取当前文档的 XmlImplementation 对象。
InnerText        获取或设置节点及其所有子节点的串联值。 (继承自 XmlNode。)
InnerXml       获取或设置表示当前节点子级的标记。 (重写 XmlNode..::.InnerXml。)
IsReadOnly      获取一个值,该值指示当前节点是否是只读的。 (重写 XmlNode..::.IsReadOnly。)
Item          已重载。
LastChild       获取节点的最后一个子级。 (继承自 XmlNode。)
LocalName       获取节点的本地名称。 (重写 XmlNode..::.LocalName。)
Name         获取节点的限定名。 (重写 XmlNode..::.Name。)
NamespaceURI    获取该节点的命名空间 URI。 (继承自 XmlNode。)
NameTable      获取与此实现关联的 XmlNameTable。
NextSibling       获取紧接在该节点之后的节点。 (继承自 XmlNode。)
NodeType       获取当前节点的类型。 (重写 XmlNode..::.NodeType。)
OuterXml        获取表示此节点及其所有子节点的标记。 (继承自 XmlNode。)
OwnerDocument   获取当前节点所属的 XmlDocument。 (重写 XmlNode..::.OwnerDocument。)
ParentNode       已重载。
Prefix          获取或设置该节点的命名空间前缀。 (继承自 XmlNode。)
PreserveWhitespace  获取或设置一个值,该值指示是否在元素内容中保留空白。
PreviousSibling    获取紧接在该节点之前的节点。 (继承自 XmlNode。)
SchemaInfo      返回节点的后架构验证信息集 (PSVI)。 (重写 XmlNode..::.SchemaInfo。)
Schemas       获取或设置与此 XmlDocument 关联的 XmlSchemaSet 对象。
Value         获取或设置节点的值。 (继承自 XmlNode。)
XmlResolver      设置 XmlResolver 以用于解析外部资源。

二、方法

AppendChild              将指定的节点添加到该节点的子节点列表的末尾。 (继承自 XmlNode。)
Clone                   创建此节点的一个副本。 (继承自 XmlNode。)
CloneNode               创建此节点的一个副本。 (重写 XmlNode..::.CloneNode(Boolean)。)
CreateAttribute            已重载。 创建具有指定名称的 XmlAttribute。
CreateCDataSection         创建包含指定数据的 XmlCDataSection。
CreateComment           创建包含指定数据的 XmlComment。
CreateDefaultAttribute         创建具有指定前缀、本地名称和命名空间 URI 的默认属性。
CreateDocumentFragment        创建 XmlDocumentFragment。
CreateDocumentType          返回新的 XmlDocumentType 对象。
CreateElement             已重载。 创建 XmlElement。
CreateEntityReference          创建具有指定名称的 XmlEntityReference。
CreateNavigator            已重载。 创建一个用于导航此文档的新 XPathNavigator 对象。
CreateNode              已重载。 创建 XmlNode。
CreateProcessingInstruction     创建一个具有指定名称和数据的 XmlProcessingInstruction。
CreateSignificantWhitespace     创建一个 XmlSignificantWhitespace 节点。
CreateTextNode           创建具有指定文本的 XmlText。
CreateWhitespace          创建一个 XmlWhitespace 节点。
CreateXmlDeclaration         创建一个具有指定值的 XmlDeclaration 节点。
GetElementById           获取具有指定 ID 的 XmlElement。
GetElementsByTagName        已重载。 返回一个 XmlNodeList,它包含与指定名称匹配的所有子代元素的列表。
GetEnumerator            提供对 XmlNode 中节点上“for each”样式迭代的支持。 (继承自 XmlNode。)
GetHashCode              用作特定类型的哈希函数。 (继承自 Object。)
GetNamespaceOfPrefix         查找当前节点范围内离给定的前缀最近的 xmlns 声明,并返回声明中的命名空间 URI。 (继承自 XmlNode。)
GetPrefixOfNamespace         查找当前节点范围内离给定的命名空间 URI 最近的 xmlns 声明,并返回声明中定义的前缀。 (继承自 XmlNode。)
ImportNode             将节点从另一个文档导入到当前文档。
InsertAfter               将指定的节点紧接着插入指定的引用节点之后。 (继承自 XmlNode。)
InsertBefore             将指定的节点紧接着插入指定的引用节点之前。 (继承自 XmlNode。)
Load                  已重载。 从 Stream、URL、TextReader 或 XmlReader 加载指定的 XML 数据。
LoadXml                从指定的字符串加载 XML 文档。
Normalize              将此 XmlNode 下子树完全深度中的所有 XmlText 节点都转换成“正常”形式,在这种形式中只有标记(即标记、注释、处理指令、                    CDATA 节和实体引用)分隔 XmlText 节点,也就是说,没有相邻的 XmlText 节点。 (继承自 XmlNode。)
PrependChild             将指定的节点添加到该节点的子节点列表的开头。 (继承自 XmlNode。)
ReadNode               根据 XmlReader 中的信息创建一个 XmlNode 对象。读取器必须定位在节点或属性上。
RemoveAll               移除当前节点的所有子节点和/或属性。 (继承自 XmlNode。)
RemoveChild             移除指定的子节点。 (继承自 XmlNode。)
ReplaceChild             用 newChild 节点替换子节点 oldChild。 (继承自 XmlNode。)
Save                 已重载。 将 XML 文档保存到指定的位置。
SelectNodes              已重载。
SelectSingleNode           已重载。
Supports               测试 DOM 实现是否实现特定的功能。 (继承自 XmlNode。)
Validate               已重载。 验证 XmlDocument 是不是 Schemas 属性中包含的 XML 架构定义语言 (XSD) 架构。
WriteContentTo           将 XmlDocument 节点的所有子级保存到指定的 XmlWriter 中。 (重写 XmlNode..::.WriteContentTo(XmlWriter)。)
WriteTo               将 XmlDocument 节点保存到指定的 XmlWriter。 (重写 XmlNode..::.WriteTo(XmlWriter)。)

 三、事件

NodeChanged        当属于该文档的节点的 Value 已被更改时发生。
NodeChanging       当属于该文档的节点的 Value 将被更改时发生。
NodeInserted         当属于该文档的节点已被插入另一个节点时发生。
NodeInserting        当属于该文档的节点将被插入另一个节点时发生。
NodeRemoved        当属于该文档的节点已被从其父级移除时发生。
NodeRemoving       当属于该文档的节点将被从文档中移除时发生。

助记属性:

PreviousSibling  上一个兄弟节点
NextSibling    下一个兄弟节点
FirstChild     第一个子节点
LastChild     最后一个子节点
ChildNodes    子节点集合
ParentNode     父节点

代码示例:

xml文档:

复制代码 代码如下:

<?xml version="1.0" encoding="utf-8" ?>
<Article>
  <author age="30">张三</author>
  <length>12000</length>
  <price>42</price>
</Article>

代码:

复制代码 代码如下:

static void Main(string[] args)
        {
            XmlDocument doc = new XmlDocument();
            doc.Load(@"C:\Users\Administrator\Desktop\ConsoleApplication1\ConsoleApplication1\Test.xml");
            //先获取一个唯一的Article节点,再获取其下的第一个子节点 然后再获取该节点下的属性集合
            XmlAttributeCollection xc = doc.SelectSingleNode("Article").FirstChild.Attributes;
            string age = xc[0].Value;   //不过是一个定制的集合罢了,还是集合那套东西 //string age = xc["age"].Value; 支持两种索引访问
            Console.WriteLine(age);     //输出30

            string baseuri = doc.SelectSingleNode("Article").FirstChild.BaseURI;   
            Console.WriteLine(baseuri);     //输出 file:///C:\Users\Administrator\Desktop\ConsoleApplication1\ConsoleApplication1\Test.xml

            XmlNodeList listNode = doc.SelectSingleNode("Article").ChildNodes;  //获取Article节点下的所有节点列表
            for (int i = 0; i < listNode.Count;i++ )    //XmlNodeList不支持foreach遍历,只能用for
            {
                Console.Write(listNode[i].Name + " : " + listNode[i].InnerText);    //输出 author:张三 length:12000 price:30    Name获取的是限定名,也就是标记名称
            }

            XmlElement xe = doc.DocumentElement;    //获取根节点
            Console.WriteLine(xe.Name);     //输出 Article   

            //XmlDocumentType xdt = doc.DocumentType;     //获取包含 DOCTYPE 声明的节点。应该是由DTD限定的节点。
            //Console.Write(xdt.Name);  //此处报 未将对象引用设置到对象的实例,因为找不到有DOCTYPE声明的元素

            Console.WriteLine(doc.HasChildNodes);    //输出 True 当前Document是否包含子节点。

            //XmlImplementation xi = doc.Implementation;    //不懂怎么用
            //xi.ToString();   


            Console.WriteLine(doc.InnerText);   //获取当前文档的内容 输出 张三 12000 30
            Console.WriteLine(doc.InnerXml);    //输出 整个Xml文件的字符串内容
            Console.WriteLine(doc.IsReadOnly);  //获取当前文档是否是只读的。输出 False
            XmlNode node = doc.LastChild;
            Console.WriteLine(node.InnerText);  //输出 张三 12000 30    因为最后一个节点是Article节点,输出Article节点的所有内容
            Console.WriteLine(doc.LocalName);   //输出 #document
            Console.WriteLine(doc.SelectSingleNode("Article").Name);    //输出Article
            Console.WriteLine(doc.SelectSingleNode("Article").FirstChild.NextSibling.Name);     //length author的下一个兄弟节点 是length
            XmlNodeType xnt = doc.SelectSingleNode("Article").NodeType;
            Console.WriteLine(xnt);  //输出Element,表明该节点是元素节点
            string str = doc.SelectSingleNode("Article").OuterXml;  //此节点及其所有自己点标记,输出Article节点的所有内容 <Article>省略...</Article>
            Console.WriteLine(str);
            XmlDocument x = new XmlDocument();
            x.LoadXml(str);

            Console.WriteLine(doc.SelectSingleNode("Article").OwnerDocument);   //获取该节点所属的XmlDocument
            XmlNode xn = doc.SelectSingleNode("Article").LastChild.ParentNode;  //ParentNode获取直接父节点。
            Console.WriteLine(xn.Name); //输出 Article

            Console.WriteLine(doc.PreserveWhitespace);  //是否保留空白    输出False
            XmlNode xn1 = doc.SelectSingleNode("Article").LastChild.PreviousSibling;
            Console.WriteLine(xn1.Name);    //输出length 的确是最后一个节点的前一个节点。

            Console.ReadKey();
        }

    为了更加好的展示一些属性,现在将xml换成这样:

复制代码 代码如下:

<?xml version="1.0" encoding="utf-8" ?>
<h:Article xmlns:h = "http://www.xxx.com/">
  <!--默认命名空间-->
  <h:author age="30">张三</h:author>
  <h:length>12000</h:length>
  <h:price>42</h:price>
</h:Article>

代码如下:

复制代码 代码如下:

static void Main(string[] args)
        {
            XmlDocument doc = new XmlDocument();
            doc.Load(@"C:\Users\Administrator\Desktop\ConsoleApplication1\ConsoleApplication1\Test.xml");
            XmlNamespaceManager xnm = new XmlNamespaceManager(doc.NameTable);
            xnm.AddNamespace("h", "http://www.xxx.com/");
            XmlNode Article = doc.SelectSingleNode("h:Article", xnm);
            string namespace1 = Article.InnerText;
            Console.WriteLine(namespace1);      //输出 张三 12000 30

            Console.WriteLine(Article.Prefix);  //输出 h  获取当前节点的前缀
            Console.WriteLine(Article.NamespaceURI);    //输出 http://www.xxx.com/123  获取当前节点所在的命名空间

            Console.WriteLine(Article.FirstChild.Name + "---" + Article.FirstChild.Value + "---" + Article.FirstChild.LocalName);
            //以上一行代码输出 h:author------author

             //SchemaInfo 返回节点的后架构验证信息集 (PSVI)。//Value 获取或设置节点的值。 (继承自 XmlNode。)
             //XmlResolver 设置 XmlResolver 以用于解析外部资源。 

            Console.ReadKey();
        }

 再来一个展示一下Schemas这个常用的属性

复制代码 代码如下:

static void Main(string[] args)
        {
            XmlDocument doc = new XmlDocument();    //创建文档
            doc.Schemas.Add(null, @"C:\Users\Administrator\Desktop\ConsoleApplication1\ConsoleApplication1\person.xsd");    //添加一个架构对象到本XmlDocument
            doc.Load(@"C:\Users\Administrator\Desktop\ConsoleApplication1\ConsoleApplication1\person.xml");     //加载xml文件
            Console.WriteLine(doc.Schemas.Count);   //输出1 就是第二行添加的那个
            Console.WriteLine(doc.SchemaInfo.MemberType);
            //XmlResolver 设置 XmlResolver 以用于解析外部资源。 

            Console.ReadKey();
        }

下面来试下XmlDocument的方法

Test.xml的代码如下:

复制代码 代码如下:

<?xml version="1.0" encoding="utf-8" ?>
<bookstore>
  <book>
    <id>1</id>
    <title lang="属性1">三国演义</title>
    <author>罗贯中</author>
    <year>2005</year>
    <price id='a1"'>38.5</price>
  </book>
  <book>
    <id>2</id>
    <title lang="属性2">西游记</title>
    <author>吴承恩</author>
    <year>2004</year>
    <price>37.5</price>
  </book>
</bookstore>

主程序代码如下:

复制代码 代码如下:

static void Main(string[] args)
        {
            XmlDocument doc = new XmlDocument();    //创建文档
            doc.Load(@"C:\Users\Administrator\Desktop\ConsoleApplication1\ConsoleApplication1\Test.xml");     //加载xml文件

            XmlNode node1 = doc.CreateNode(XmlNodeType.Element, "pagecount", null);
            node1.InnerText = "222";
            doc.SelectSingleNode("/bookstore").AppendChild(node1); //执行之后 <pagecount>222</pagecount>元素被添加到</bookstore>前面
            doc.Save(@"D:\123.xml");

            XmlNode node2 = doc.SelectSingleNode("/bookstore/book[1]/title[1]").Clone();    //克隆一个节点出来
            Console.WriteLine(node2.InnerText);     //输出三国演义

            XmlNode node3 = doc.SelectSingleNode("/bookstore/book[1]/title[1]").CloneNode(true);   //参数决定是否克隆子节点数(如果false,文本节点也不克隆)
            Console.WriteLine(node3.InnerText);     //输出三国演义

            XmlAttribute attr = doc.CreateAttribute("age");     //创建一个age属性
            attr.Value = "23";
            doc.SelectSingleNode("/bookstore/book[1]/author[1]").Attributes.Append(attr);   //执行之后第一个作者变为 <author age="23">罗贯中</author>
            doc.Save(@"D:\123.xml");

            XmlCDataSection cdata = doc.CreateCDataSection("我&你");
            doc.SelectSingleNode("/bookstore/book[1]/author[1]").AppendChild(cdata);        //执行之后author变为<author age="23">罗贯中<![CDATA[我&你]]></author>
            doc.Save(@"D:\123.xml");

            XmlComment com = doc.CreateComment("2013-2-27 22:37:25");
            doc.SelectSingleNode("/bookstore/book[1]/title[1]").AppendChild(com);   //执行之后title变为<title lang="属性1">三国演义<!--2013-2-27 22:37:25--></title>
            doc.Save(@"D:\123.xml");

            XmlDocument doc1 = new XmlDocument();
            XmlDocumentFragment xdf = doc1.CreateDocumentFragment();    //一个xml片段,这个类敢情好用
            xdf.InnerXml = "<item>widget</item>";
            doc1.AppendChild(xdf);
            Console.WriteLine(doc1.OuterXml);   //输出<item>widget</item>

            //CreateDefaultAttribute         创建具有指定前缀、本地名称和命名空间 URI 的默认属性。
            //CreateDocumentType          返回新的 XmlDocumentType 对象。

            XmlDocument doc2 = new XmlDocument();
            XmlElement element = doc2.CreateElement("title");   //创建一个title 如果现在保存是输出<title/> 因为还没有内容
            doc2.AppendChild(element);
            XmlEntityReference xer = doc2.CreateEntityReference("h");
            doc2.LastChild.AppendChild(xer);
            Console.WriteLine(doc2.OuterXml);   //输出</title>&h;</title>

            XPathNavigator nav = doc2.CreateNavigator();    //一个通过光标的导航模型遍历XML文档的数据

            XmlText text = doc2.CreateTextNode("你好啊");  //创建一个文本节点
            doc2.SelectSingleNode("/title").AppendChild(text);
            Console.WriteLine(doc2.OuterXml);   //输出</title>&h;你好啊</title>

            XmlWhitespace xws = doc2.CreateWhitespace("     ");     //创建一个空白节点
            doc2.SelectSingleNode("/title").AppendChild(xws);
            Console.WriteLine(doc2.OuterXml);   //输出</title>&h;你好啊     </title>

            XmlDeclaration xd = doc2.CreateXmlDeclaration("1.0", "utf-8", "yes");  //xml头  XML声明部分
            XmlNode root = doc2.SelectSingleNode("/title");
            doc2.InsertBefore(xd, root);
            Console.WriteLine(doc2.OuterXml);   //执行之后 在头部加入了<?xml version="1.0" encoding="utf-8" standalont="yes"?>

            XmlSignificantWhitespace xsw = doc2.CreateSignificantWhitespace("      ");
            XmlElement ele = doc2.CreateElement("white");
            ele.InnerText = "空白啊空白";
            ele.AppendChild(xsw);
            doc2.SelectSingleNode("/title").AppendChild(ele);
            Console.WriteLine(doc2.OuterXml);       //还是添加一大堆空白,不知道与CreateWhitespace有什么区别

            XmlDocument doc3 = new XmlDocument();
            String PItext = "type='text/xsl' href='book.xsl'";
            XmlProcessingInstruction newPI = doc3.CreateProcessingInstruction("xml-stylesheet", PItext);
            doc3.AppendChild(newPI);
            Console.WriteLine(doc3.OuterXml);   //输出 <?xml-stylesheet type="text/xsl" hred="book.xsl"?>
            //GetElementById           获取具有指定 ID 的 XmlElement。
            //GetElementsByTagName        已重载。 返回一个 XmlNodeList,它包含与指定名称匹配的所有子代元素的列表。
            //GetEnumerator            提供对 XmlNode 中节点上“for each”样式迭代的支持。 (继承自 XmlNode。)
            //GetNamespaceOfPrefix         查找当前节点范围内离给定的前缀最近的 xmlns 声明,并返回声明中的命名空间 URI。 (继承自 XmlNode。)
            //GetPrefixOfNamespace         查找当前节点范围内离给定的命名空间 URI 最近的 xmlns 声明,并返回声明中定义的前缀。 (继承自 XmlNode。)
            //ImportNode             将节点从另一个文档导入到当前文档。
            //InsertAfter               将指定的节点紧接着插入指定的引用节点之后。 (继承自 XmlNode。)
            //InsertBefore             将指定的节点紧接着插入指定的引用节点之前。 (继承自 XmlNode。)

            //LoadXml                从指定的字符串加载 XML 文档。
            //Normalize              将此 XmlNode 下子树完全深度中的所有 XmlText 节点都转换成“正常”形式,在这种形式中只有标记(即标记、注释、处理指令、                    CDATA 节和实体引用)分隔 XmlText 节点,也就是说,没有相邻的 XmlText 节点。 (继承自 XmlNode。)
            //PrependChild             将指定的节点添加到该节点的子节点列表的开头。 (继承自 XmlNode。)
            //ReadNode               根据 XmlReader 中的信息创建一个 XmlNode 对象。读取器必须定位在节点或属性上。
            //RemoveAll               移除当前节点的所有子节点和/或属性。 (继承自 XmlNode。)
            //RemoveChild             移除指定的子节点。 (继承自 XmlNode。)
            //ReplaceChild             用 newChild 节点替换子节点 oldChild。 (继承自 XmlNode。)


            //Supports               测试 DOM 实现是否实现特定的功能。 (继承自 XmlNode。)
            //Validate               已重载。 验证 XmlDocument 是不是 Schemas 属性中包含的 XML 架构定义语言 (XSD) 架构。
            //WriteContentTo           将 XmlDocument 节点的所有子级保存到指定的 XmlWriter 中。 (重写 XmlNode..::.WriteContentTo(XmlWriter)。)
            //WriteTo               将 XmlDocument 节点保存到指定的 XmlWriter。 (重写 XmlNode..::.WriteTo(XmlWriter)。)
            Console.ReadKey();
        }