一、開發與執行環境
(一)微軟 Windows 2000 伺服器版
(二).NET Framework SDK Beta 2
二、用 C# 建立 XML 文件
本文介紹以 C# 建立 XML 文件的兩種典型做法:第一種逐步依結構組裝,較為靈活;第二種直接定義整份 XML,較為省事。兩者各有適用的場合。
(一)第一種方法:逐步組裝
這種做法依 XML 的結構一步步搭建文件,靠的是 .NET Framework SDK 中 System.Xml 命名空間所封裝的各類別。
(1)先建立一個空的 XML 文件。System.Xml 中的 XmlDocument 類別用來描述 XML 文件:
xmldoc = new System.Xml.XmlDocument();
(2)在文件最開頭加入 XML 宣告段落。可利用 XmlDocument 的 CreateNode 方法建立指定型別的節點(本文採用其一般形式 XmlDocument.CreateNode(XMLNodeType, String, String)),再用 AppendChild 把節點加入文件:
xmlnode = xmldoc.CreateNode(XmlNodeType.XMLDeclaration, "", ""); xmldoc.AppendChild(xmlnode);
(3)為文件加入元素。內容是透過元素承載的,XmlDocument 提供了 CreateElement 與 CreateTextNode 兩個方法:前者建立元素,後者為元素指定文字值。以下為文件加上一個根元素:
xmlelem = xmldoc.CreateElement("", "ROOT", "");
xmltext = xmldoc.CreateTextNode("Root Text");其中 xmlelem 是 XmlElement 物件,xmltext 是 XmlText 物件。有了建立單一元素的範例,就能依資料的不同結構建立其餘元素。
(二)第一種方法的完整程式碼(NO1.cs)
using System;
using System.Xml;
class MainClass
{
XmlDocument xmldoc;
XmlNode xmlnode;
XmlElement xmlelem;
XmlElement xmlelem2;
XmlText xmltext;
static void Main(string[] args)
{
MainClass app = new MainClass();
}
public MainClass()
{
xmldoc = new XmlDocument();
//加入 XML 的宣告段落
xmlnode = xmldoc.CreateNode(XmlNodeType.XMLDeclaration, "", "");
xmldoc.AppendChild(xmlnode);
//加入一個根元素
xmlelem = xmldoc.CreateElement("", "ROOT", "");
xmltext = xmldoc.CreateTextNode("Root Text");
xmlelem.AppendChild(xmltext);
xmldoc.AppendChild(xmlelem);
//加入另一個元素
xmlelem2 = xmldoc.CreateElement("", "SampleElement", "");
xmltext = xmldoc.CreateTextNode("The text of the sample element");
xmlelem2.AppendChild(xmltext);
xmldoc.ChildNodes.Item(1).AppendChild(xmlelem2);
//保存建立好的 XML 文件
try
{
xmldoc.Save("c:\\data.XML");
}
catch (Exception e)
{
//顯示錯誤訊息
Console.WriteLine(e.Message);
}
Console.ReadLine();
}
}(三)第二種方法:直接定義
看完第一種方法,你應該會感覺到逐步組裝 XML 相當繁瑣,既要懂建立機制,也要熟悉文件結構。第二種方法就輕鬆多了:直接把 XML 文字定義好,存檔即可。
(1)建立一個 XmlDocument 物件,做法與第一種相同。
(2)透過 XmlDocument 的 LoadXml 方法,直接把 XML 資料寫進文件。要注意,寫入的 XML 必須符合語法,否則產生的檔案沒有意義:
doc.LoadXml( "<EMPLOYEES> " + "<NO1>" + "<NAME>Ma Jin Hu</NAME>" + "<ZIP> 239000 </ZIP>" + "Feng Huang Street" + "<CITY>Chu Zhou City</CITY>" + "<STATE> ANHUI </STATE>" + "</NO1>" + "<NO2>" + "<NAME>Wang Tian</NAME>" + "<ZIP> 239000 </ZIP>" + "Lang Ya Street" + "<CITY>He Fei City</CITY>" + "<STATE> ANHUI </STATE>" + "</NO2>" + "<NO3>" + "<NAME>Zou Wen Biao</NAME>" + "<ZIP> 100000 </ZIP>" + "Sai Di Street" + "<CITY>Bei Jin City</CITY>" + "<STATE>Bei Jin</STATE>" + "</NO3>" + "</EMPLOYEES>");
(3)用 Save 方法把文件存檔:
doc.Save("data.XML");(四)第二種方法的完整程式碼(NO2.cs)
using System;
using System.IO;
using System.Xml;
public class Sample
{
public static void Main()
{
//建立一個 XmlDocument 物件
XmlDocument doc = new XmlDocument();
doc.LoadXml(
"<EMPLOYEES> " +
"<NO1><NAME>Ma Jin Hu</NAME><ZIP> 239000 </ZIP>Feng Huang Street<CITY>Chu Zhou City</CITY><STATE> ANHUI </STATE></NO1>" +
"<NO2><NAME>Wang Tian</NAME><ZIP> 239000 </ZIP>Lang Ya Street<CITY>He Fei City</CITY><STATE> ANHUI </STATE></NO2>" +
"<NO3><NAME>Zou Wen Biao</NAME><ZIP> 100000 </ZIP>Sai Di Street<CITY>Bei Jin City</CITY><STATE>Bei Jin</STATE></NO3>" +
"</EMPLOYEES>");
//把文件存檔
doc.Save("data.XML");
}
}用 C# 建立 XML 文件的方法其實很多,這裡只挑兩種較典型的介紹。無論哪一種,都得用到 .NET Framework SDK,因此熟悉這個類庫對 C# 開發至關重要。
三、用 C# 讀取 XML 文件
本節用 C# 讀取上面第二種方法所產生的 data.xml,其結構包含三筆資料:
<EMPLOYEES>
<NO1>
<NAME>Ma Jin Hu</NAME>
<ZIP> 239000 </ZIP>
Feng Huang Street
<CITY>Chu Zhou City</CITY>
<STATE> ANHUI </STATE>
</NO1>
<NO2>
<NAME>Wang Tian</NAME>
<ZIP> 239000 </ZIP>
Lang Ya Street
<CITY>He Fei City</CITY>
<STATE> ANHUI </STATE>
</NO2>
<NO3>
<NAME>Zou Wen Biao</NAME>
<ZIP> 100000 </ZIP>
Sai Di Street
<CITY>Bei Jin City</CITY>
<STATE>Bei Jin</STATE>
</NO3>
</EMPLOYEES>要正確讀取,得先了解 XML 的結構。從上可知這份 XML 有三筆資料,接著看怎麼讀出來。
(1)先把 XML 文件載入形成資料流。建立 XmlDocument 物件後用 Load 方法載入:
XmlDocument doc = new XmlDocument();
//載入指定的 XML 文件
doc.Load("C:\\data.XML");(2)讀取並顯示。這一步透過建立 XmlNodeReader 物件來讀取 XML 節點資料,其中 NodeType 屬性用來判斷節點型別,Value 則是節點的值。以下程式把結果顯示在 ListView 中:
while (reader.Read())
{
//判斷當前讀取的節點型別
switch (reader.NodeType)
{
case XmlNodeType.Element:
s = reader.Name;
break;
case XmlNodeType.Text:
if (s.Equals("Name"))
myItem = listView1.Items.Add(reader.Value);
else
myItem.SubItems.Add(reader.Value);
break;
}
}四、讀取 XML 的完整程式碼(read.cs)
using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;
using System.Data;
using System.Xml;
public class Form1 : Form
{
private Button button1;
private ListView listView1;
private System.ComponentModel.Container components = null;
public Form1()
{
InitializeComponent();
}
protected override void Dispose(bool disposing)
{
if (disposing)
{
if (components != null)
components.Dispose();
}
base.Dispose(disposing);
}
private void InitializeComponent()
{
button1 = new Button();
listView1 = new ListView();
SuspendLayout();
button1.Anchor = ((AnchorStyles.Bottom | AnchorStyles.Left) | AnchorStyles.Right);
button1.Location = new Point(240, 296);
button1.Name = "button1";
button1.Size = new Size(112, 37);
button1.TabIndex = 0;
button1.Text = "讀取 XML 文件";
button1.Click += new System.EventHandler(button1_Click);
listView1.Anchor = (((AnchorStyles.Top | AnchorStyles.Bottom) | AnchorStyles.Left) | AnchorStyles.Right);
listView1.GridLines = true;
listView1.Location = new Point(10, 9);
listView1.Name = "listView1";
listView1.Size = new Size(623, 269);
listView1.TabIndex = 1;
listView1.View = View.Details;
this.AutoScaleBaseSize = new Size(6, 14);
this.ClientSize = new Size(608, 348);
this.Controls.Add(listView1);
this.Controls.Add(button1);
this.Name = "Form1";
this.StartPosition = FormStartPosition.CenterScreen;
this.Text = "用 C# 讀取 XML 文件";
this.ResumeLayout(false);
}
static void Main()
{
Application.Run(new Form1());
}
private void button1_Click(object sender, System.EventArgs e)
{
ListViewItem myItem = new ListViewItem();
//建立 listView 欄位
listView1.Columns.Clear();
listView1.Items.Clear();
listView1.Columns.Add("Name", 80, HorizontalAlignment.Left);
listView1.Columns.Add("Zip", 80, HorizontalAlignment.Left);
listView1.Columns.Add("Address", 80, HorizontalAlignment.Left);
listView1.Columns.Add("City", 80, HorizontalAlignment.Left);
listView1.Columns.Add("State", 80, HorizontalAlignment.Left);
XmlNodeReader reader = null;
try
{
string s = "";
XmlDocument doc = new XmlDocument();
doc.Load("C:\\data.XML");
reader = new XmlNodeReader(doc);
while (reader.Read())
{
switch (reader.NodeType)
{
case XmlNodeType.Element:
s = reader.Name;
break;
case XmlNodeType.Text:
if (s.Equals("Name"))
myItem = listView1.Items.Add(reader.Value);
else
myItem.SubItems.Add(reader.Value);
break;
}
}
}
finally
{
if (reader != null)
reader.Close();
}
}
}五、總結
C# 與 XML 淵源匪淺,本文只是從一個側面反映了兩者的密切關係。.NET Framework SDK 中有許多可直接操作 XML 的類別,掌握它們的使用方式,對以 C# 開發 XML 相關應用相當重要。