我们今天来讲一下该体系结构中的XmlTextReader类,该类提供对Xml文件进行读取的功能,它可以验证文档是否格式良好,如果不是格式良好的Xml文档,该类在读取过程中将会抛出XmlException异常,可使用该类提供的一些方法对文档节点进行读取,筛选等操作以及得到节点的名称和值,请牢记:XmlTextReader是基于流模型的实现,打个不恰当的比喻,XML文件就好象水源,闸一开水就流出,流过了就流过了不会也不可以往回流。内存中任何时候只有当前节点,你可以使用XmlTextReader类的Read()方法读取下一个节点。好了,说了这么多来看一个例子,编程要注重实际对吧。看代码前先看下运行效果吧!
Example1按纽遍历文档读取数据,Example2,Example3按纽得到节点类型,Example4过滤文档只获得数据内容,Example5得到属性节点,Example6按纽得到命名空间,Example7显示整个XML文档,为此,我专门写一个类来封装以上功能,该类代码如下:
//---------------------------------------------------------------------------------------------------
//XmlReader类用于Xml文件的一般读取操作,以下对这个类做简单介绍:
//
//Attributes(属性):
//listBox: 设置该属性主要为了得到客户端控件以便于显示所读到的文件的内容(这里是ListBox控件)
//xmlPath: 设置该属性为了得到一个确定的Xml文件的绝对路径
//
//Basilic Using(重要的引用):
//System.Xml: 该命名空间中封装有对Xml进行操作的常用类,本类中使用了其中的XmlTextReader类
//XmlTextReader: 该类提供对Xml文件进行读取的功能,它可以验证文档是否格式良好,如果不是格式 // 良好的Xml文档,该类在读取过程中将会抛出XmlException异常,可使用该类提供的
// 一些方法对文档节点进行读取,筛选等操作以及得到节点的名称和值
//
//bool XmlTextReader.Read(): 读取流中下一个节点,当读完最后一个节点再次调用该方法该方法返回false
//XmlNodeType XmlTextReader.NodeType: 该属性返回当前节点的类型
// XmlNodeType.Element 元素节点
// XmlNodeType.EndElement 结尾元素节点
// XmlNodeType.XmlDeclaration 文档的第一个节点
// XmlNodeType.Text 文本节点
//bool XmlTextReader.HasAttributes: 当前节点有没有属性,返回true或false
//string XmlTextReader.Name: 返回当前节点的名称
//string XmlTextReader.Value: 返回当前节点的值
//string XmlTextReader.LocalName: 返回当前节点的本地名称
//string XmlTextReader.NamespaceURI: 返回当前节点的命名空间URI
//string XmlTextReader.Prefix: 返回当前节点的前缀
//bool XmlTextReader.MoveToNextAttribute(): 移动到当前节点的下一个属性
//---------------------------------------------------------------------------------------------------
namespace XMLReading
{
using System;
using System.Xml;
using System.Windows.Forms;
using System.ComponentModel;
/// <summary>
/// Xml文件读取器
/// </summary>
public class XmlReader : IDisposable
{
private string _xmlPath;
private const string _errMsg = "Error Occurred While Reading ";
private ListBox _listBox;
private XmlTextReader xmlTxtRd;
#region XmlReader 的构造器
public XmlReader()
{
this._xmlPath = string.Empty;
this._listBox = null;
this.xmlTxtRd = null;
}
/// <summary>
/// 构造器
/// </summary>
/// <param name="_xmlPath">xml文件绝对路径</param>
/// <param name="_listBox">列表框用于显示xml</param>
public XmlReader(string _xmlPath, ListBox _listBox)
{
this._xmlPath = _xmlPath;
this._listBox = _listBox;
this.xmlTxtRd = null;
}
#endregion
#region XmlReader 的资源释放方法
/// <summary>
/// 清理该对象所有正在使用的资源
/// </summary>
public void Dispose()
{
this.Dispose(true);
GC.SuppressFinalize(this);
}
/// <summary>
/// 释放该对象的实例变量
/// </summary>
/// <param name="disposing"></param>
protected virtual void Dispose(bool disposing)
{
if (!disposing)
return;
if (this.xmlTxtRd != null)
{
this.xmlTxtRd.Close();
this.xmlTxtRd = null;
}
if (this._xmlPath != null)
{
this._xmlPath = null;
}
}
#endregion
#region XmlReader 的属性
/// <summary>
/// 获取或设置列表框用于显示xml
/// </summary>
public ListBox listBox
{
get
{
return this._listBox;
}
set
{
this._listBox = value;
}
}
/// <summary>
/// 获取或设置xml文件的绝对路径
/// </summary>
public string xmlPath
{
get
{
return this._xmlPath;
}
set
{
this._xmlPath = value;
}
}
#endregion
/// <summary>
/// 遍历Xml文件
/// </summary>
public void EachXml()
{
this._listBox.Items.Clear();
this.xmlTxtRd = new XmlTextReader(this._xmlPath);
try
{
while(xmlTxtRd.Read())
{
this._listBox.Items.Add(this.xmlTxtRd.Value);
}
}
catch(XmlException exp)
{
throw new XmlException(_errMsg + this._xmlPath + exp.ToString());
}
finally
{
if (this.xmlTxtRd != null)
this.xmlTxtRd.Close();
}
}
/// <summary>
/// 读取Xml文件的节点类型
/// </summary>
public void ReadXmlByNodeType()
{
this._listBox.Items.Clear();
this.xmlTxtRd = new XmlTextReader(this._xmlPath);
try
{
while(xmlTxtRd.Read())
{
this._listBox.Items.Add(this.xmlTxtRd.NodeType.ToString());
}
}
catch(XmlException exp)
{
throw new XmlException(_errMsg + this._xmlPath + exp.ToString());
}
finally
{
if (this.xmlTxtRd != null)
this.xmlTxtRd.Close();
}
}
/// <summary>
/// 根据节点类型过滤Xml文档
/// </summary>
/// <param name="xmlNType">XmlNodeType 节点类型的数组</param>
public void FilterByNodeType(XmlNodeType[] xmlNType)
{
this._listBox.Items.Clear();
this.xmlTxtRd = new XmlTextReader(this._xmlPath);
try
{
while(xmlTxtRd.Read())
{
for (int i = 0; i < xmlNType.Length; i++)
{
if (xmlTxtRd.NodeType == xmlNType[i])
{
this._listBox.Items.Add(xmlTxtRd.Name + " is Type " + xmlTxtRd.NodeType.ToString());
}
}
}
}
catch(XmlException exp)
{
throw new XmlException(_errMsg + this.xmlPath + exp.ToString());
}
finally
{
if (this.xmlTxtRd != null)
this.xmlTxtRd.Close();
}
}
/// <summary>
/// 读取Xml文件的所有文本节点值
/// </summary>
public void ReadXmlTextValue()
{
this._listBox.Items.Clear();
this.xmlTxtRd = new XmlTextReader(this._xmlPath);
try
{
while(xmlTxtRd.Read())
{
if (xmlTxtRd.NodeType == XmlNodeType.Text)
{
this._listBox.Items.Add(xmlTxtRd.Value);
}
}
}
catch(XmlException xmlExp)
{
throw new XmlException(_errMsg + this._xmlPath + xmlExp.ToString());
}
finally
{
if (this.xmlTxtRd != null)
this.xmlTxtRd.Close();
}
}
/// <summary>
/// 读取Xml文件的属性
/// </summary>
public void ReadXmlAttributes()
{
this._listBox.Items.Clear();
this.xmlTxtRd = new XmlTextReader(this._xmlPath);
try
{
while(xmlTxtRd.Read())
{
if (xmlTxtRd.NodeType == XmlNodeType.Element)
{
if (xmlTxtRd.HasAttributes)
{
this._listBox.Items.Add("The Element " + xmlTxtRd.Name + " has " + xmlTxtRd.AttributeCount + " Attributes");
this._listBox.Items.Add("The Attributes are:");
while(xmlTxtRd.MoveToNextAttribute())
{
this._listBox.Items.Add(xmlTxtRd.Name + " = " + xmlTxtRd.Value);
}
}
else
{
this._listBox.Items.Add("The Element " + xmlTxtRd.Name + " has no Attribute");
}
this._listBox.Items.Add("");
}
}
}
catch(XmlException xmlExp)
{
throw new XmlException(_errMsg + this._xmlPath + xmlExp.ToString());
}
finally
{
if (this.xmlTxtRd != null)
this.xmlTxtRd.Close();
}
}
/// <summary>
/// 读取Xml文件的命名空间
/// </summary>
public void ReadXmlNamespace()
{
this._listBox.Items.Clear();
this.xmlTxtRd = new XmlTextReader(this._xmlPath);
try
{
while(xmlTxtRd.Read())
{
if (xmlTxtRd.NodeType == XmlNodeType.Element && xmlTxtRd.Prefix != "")
{
this._listBox.Items.Add("The Prefix " + xmlTxtRd.Prefix + " is associated with namespace " + xmlTxtRd.NamespaceURI);
this._listBox.Items.Add("The Element with the local name " + xmlTxtRd.LocalName + " is associated with" + " the namespace " + xmlTxtRd.NamespaceURI);
}
if (xmlTxtRd.NodeType == XmlNodeType.Element && xmlTxtRd.HasAttributes)
{
while(xmlTxtRd.MoveToNextAttribute())
{
if (xmlTxtRd.Prefix != "")
{
this._listBox.Items.Add("The Prefix " + xmlTxtRd.Prefix + " is associated with namespace " + xmlTxtRd.NamespaceURI);
this._listBox.Items.Add("The Attribute with the local name " + xmlTxtRd.LocalName + " is associated with the namespace " + xmlTxtRd.NamespaceURI);
}
}
}
}
}
catch(XmlException xmlExp)
{
throw new XmlException(_errMsg + this._xmlPath + xmlExp.ToString());
}
finally
{
if (this.xmlTxtRd != null)
this.xmlTxtRd.Close();
}
}
/// <summary>
/// 读取整个Xml文件
/// </summary>
public void ReadXml()
{
string attAndEle = string.Empty;
this._listBox.Items.Clear();
this.xmlTxtRd = new XmlTextReader(this._xmlPath);
try
{
while(xmlTxtRd.Read())
{
if (xmlTxtRd.NodeType == XmlNodeType.XmlDeclaration)
this._listBox.Items.Add(string.Format("<?{0} {1} ?>",xmlTxtRd.Name,xmlTxtRd.Value));
else if (xmlTxtRd.NodeType == XmlNodeType.Element)
{
attAndEle = string.Format("<{0} ",xmlTxtRd.Name);
if (xmlTxtRd.HasAttributes)
{
while(xmlTxtRd.MoveToNextAttribute())
{
attAndEle = attAndEle + string.Format("{0}='{1}' ",xmlTxtRd.Name,xmlTxtRd.Value);
}
}
attAndEle = attAndEle.Trim() + ">";
this._listBox.Items.Add(attAndEle);
}
else if (xmlTxtRd.NodeType == XmlNodeType.EndElement)
this._listBox.Items.Add(string.Format("</{0}>",xmlTxtRd.Name));
else if (xmlTxtRd.NodeType == XmlNodeType.Text)
this._listBox.Items.Add(xmlTxtRd.Value);
}
}
catch(XmlException xmlExp)
{
throw new XmlException(_errMsg + this._xmlPath + xmlExp.ToString());
}
finally
{
if (this.xmlTxtRd != null)
this.xmlTxtRd.Close();
}
}
}
}
窗体代码如下:
namespace XMLReading { using System; using System.Drawing; using System.Collections; using System.ComponentModel; using System.Windows.Forms; using System.Data; using System.Xml; public class Form1 : System.Windows.Forms.Form { private System.Windows.Forms.ListBox listBox1; private System.Windows.Forms.Button button1; private System.Windows.Forms.Button button2; private System.Windows.Forms.Button button3; private System.Windows.Forms.Button button4; private System.Windows.Forms.Button button5; private System.Windows.Forms.Button button6; private System.Windows.Forms.Button button7; private string xmlPath; private XmlReader xRead; /// <summary> /// 必需的设计器变量。 /// </summary> private System.ComponentModel.Container components = null; public Form1() { InitializeComponent(); } /// <summary> /// 清理所有正在使用的资源。 /// </summary> protected override void Dispose( bool disposing ) { if( disposing ) { if (components != null) { components.Dispose(); } } base.Dispose( disposing ); } #region Windows 窗体设计器生成的代码 /// <summary> /// 设计器支持所需的方法 - 不要使用代码编辑器修改 /// 此方法的内容。 /// </summary> private void InitializeComponent() { this.listBox1 = new System.Windows.Forms.ListBox(); this.button1 = new System.Windows.Forms.Button(); this.button2 = new System.Windows.Forms.Button(); this.button3 = new System.Windows.Forms.Button(); this.button4 = new System.Windows.Forms.Button(); this.button5 = new System.Windows.Forms.Button(); this.button6 = new System.Windows.Forms.Button(); this.button7 = new System.Windows.Forms.Button(); this.SuspendLayout(); // // listBox1 // this.listBox1.Anchor = ((System.Windows.Forms.AnchorStyles)((((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom) | System.Windows.Forms.AnchorStyles.Left) | System.Windows.Forms.AnchorStyles.Right))); this.listBox1.ItemHeight = 12; this.listBox1.Location = new System.Drawing.Point(8, 8); this.listBox1.Name = "listBox1"; this.listBox1.Size = new System.Drawing.Size(716, 460); this.listBox1.TabIndex = 0; // // button1 // this.button1.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left))); this.button1.Location = new System.Drawing.Point(8, 488); this.button1.Name = "button1"; this.button1.TabIndex = 1; this.button1.Text = "Example1"; this.button1.Click += new System.EventHandler(this.button1_Click); // // button2 // this.button2.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left))); this.button2.Location = new System.Drawing.Point(96, 488); this.button2.Name = "button2"; this.button2.TabIndex = 2; this.button2.Text = "Example2"; this.button2.Click += new System.EventHandler(this.button2_Click); // // button3 // this.button3.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Right))); this.button3.Location = new System.Drawing.Point(648, 488); this.button3.Name = "button3"; this.button3.TabIndex = 3; this.button3.Text = "Example7"; this.button3.Click += new System.EventHandler(this.button3_Click); // // button4 // this.button4.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left))); this.button4.Location = new System.Drawing.Point(184, 488); this.button4.Name = "button4"; this.button4.TabIndex = 4; this.button4.Text = "Example3"; this.button4.Click += new System.EventHandler(this.button4_Click); // // button5 // this.button5.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left))); this.button5.Location = new System.Drawing.Point(272, 488); this.button5.Name = "button5"; this.button5.TabIndex = 5; this.button5.Text = "Example4"; this.button5.Click += new System.EventHandler(this.button5_Click); // // button6 // this.button6.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left))); this.button6.Location = new System.Drawing.Point(360, 488); this.button6.Name = "button6"; this.button6.TabIndex = 6; this.button6.Text = "Example5"; this.button6.Click += new System.EventHandler(this.button6_Click); // // button7 // this.button7.Anchor = ((System.Windows.Forms.AnchorStyles)((System.Windows.Forms.AnchorStyles.Bottom | System.Windows.Forms.AnchorStyles.Left))); this.button7.Location = new System.Drawing.Point(448, 488); this.button7.Name = "button7"; this.button7.TabIndex = 7; this.button7.Text = "Example6"; this.button7.Click += new System.EventHandler(this.button7_Click); // // Form1 // this.AutoScaleBaseSize = new System.Drawing.Size(6, 14); this.ClientSize = new System.Drawing.Size(728, 517); this.Controls.Add(this.button7); this.Controls.Add(this.button6); this.Controls.Add(this.button5); this.Controls.Add(this.button4); this.Controls.Add(this.button3); this.Controls.Add(this.button2); this.Controls.Add(this.button1); this.Controls.Add(this.listBox1); this.Name = "Form1"; this.Text = "XMLReader"; this.ResumeLayout(false); // // xmlPath // this.xmlPath = "sample.xml"; } #endregion /// <summary> /// 应用程序的主入口点。 /// </summary> [STAThread] static void Main() { Application.Run(new Form1()); } private void button1_Click(object sender, System.EventArgs e) { xRead = new XmlReader(this.xmlPath,this.listBox1); try { xRead.EachXml(); } catch(XmlException xmlExp) { MessageBox.Show(xmlExp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } catch(Exception exp) { MessageBox.Show(exp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } finally { xRead.Dispose(); } } private void button2_Click(object sender, System.EventArgs e) { xRead = new XmlReader(this.xmlPath,this.listBox1); try { xRead.ReadXmlByNodeType(); } catch(XmlException xmlExp) { MessageBox.Show(xmlExp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } catch(Exception exp) { MessageBox.Show(exp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } finally { xRead.Dispose(); } } private void button3_Click(object sender, System.EventArgs e) { XmlNodeType[] xmlNType = {XmlNodeType.Element, XmlNodeType.EndElement, XmlNodeType.XmlDeclaration}; xRead = new XmlReader(this.xmlPath, this.listBox1); try { xRead.FilterByNodeType(xmlNType); } catch(XmlException xmlExp) { MessageBox.Show(xmlExp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } catch(Exception exp) { MessageBox.Show(exp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } finally { xRead.Dispose(); } } private void button4_Click(object sender, System.EventArgs e) { xRead = new XmlReader(this.xmlPath, this.listBox1); try { xRead.ReadXmlTextValue(); } catch(XmlException xmlExp) { MessageBox.Show(xmlExp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } catch(Exception exp) { MessageBox.Show(exp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } finally { xRead.Dispose(); } } private void button5_Click(object sender, System.EventArgs e) { xRead = new XmlReader(this.xmlPath, this.listBox1); try { xRead.ReadXmlAttributes(); } catch(XmlException xmlExp) { MessageBox.Show(xmlExp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } catch(Exception exp) { MessageBox.Show(exp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } finally { xRead.Dispose(); } } private void button6_Click(object sender, System.EventArgs e) { xRead = new XmlReader(this.xmlPath, this.listBox1); try { xRead.ReadXmlNamespace(); } catch(XmlException xmlExp) { MessageBox.Show(xmlExp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } catch(Exception exp) { MessageBox.Show(exp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } finally { xRead.Dispose(); } } private void button7_Click(object sender, System.EventArgs e) { xRead = new XmlReader(this.xmlPath, this.listBox1); try { xRead.ReadXml(); } catch(XmlException xmlExp) { MessageBox.Show(xmlExp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } catch(Exception exp) { MessageBox.Show(exp.ToString(),"Error",MessageBoxButtons.OK,MessageBoxIcon.Error); } finally { xRead.Dispose(); } } } } |
以下是用于测试的XML文件:
在项目中新建一个XML文件取名为sample.xml,建好后把该文件拷到项目的bin目录下的Debug目录下
<?xml version="1.0" encoding="utf-8" ?> <Invoices date="28/11/2001" xmlns:cat="uri:Business-Categories"> <customers custname="Chile Wines Inc" phone="1241 923 56332" email="cw@yahoo.com.cn" custid="192398" delivery="international" offerID="27"> <cat:businfo>Wine Division South</cat:businfo> <cat:businfo>Beer Division North</cat:businfo> <order orderID="OID921" batchid="123"> <details> <items cat:num="2"> <item>Rancagua While</item> <item>Rancagua Red</item> </items> </details> </order> <order orderID="OID927"> <details> <items num="5"> <item>Chillan Red</item> <item>Rancagua While</item> <item>Santiago Red</item> <item>Rancagua While</item> <item>Rancagua Red</item> </items> </details> </order> <order orderID="OID931" batchid="123"> <details> <items num="6"> <item>Rancegao Red</item> <item>Sutothad Black</item> <item>BlackNme Blue</item> <item>Booklist Red</item> <item>Rancegao White</item> </items> </details> </order> </customers> </Invoices> |