C#代码创建Xml文件
擴展標(biāo)記語言XML(eXtensible Markup Language),是由W3C組織制定的。做為用于替代HTML語言的一種新型的標(biāo)記語言,XML內(nèi)部有著很多基本標(biāo)準(zhǔn),XML就是通過與這些相關(guān)標(biāo)準(zhǔn)地結(jié)合,應(yīng)用于科學(xué)計算、電子出版、多媒體制作和電子商務(wù)的。C#作為一種新型的程序語言,是.Net框架的一個重要組成部分,他和XML的關(guān)系頗深。本文就從一個方面來探討一下這二者的關(guān)系。即:看用C#如何來創(chuàng)建和讀取XML文檔。
隨著XML的普及以及在動態(tài)WEB應(yīng)用程序中大量應(yīng)用,如何通過.NET創(chuàng)建,刪除,修改XML文件變的也來也重要了。一個簡單的概念是,XML文件跟大的文本文件并沒有什么區(qū)別,同時它是先于.NET出現(xiàn),很多ASP的開發(fā)者,當(dāng)他需要程序輸出XML文件的時候,通常都是用Response.Write()方法輸出為XML文檔。
使用Response.Write()的方式來輸出XML文檔,并不是一種那么好的方法,首先,我們用這種方法輸出字符以組成XML文件的時候,我們會很擔(dān)心輸出的這些字符是不是符合XML規(guī)范,不符合XML規(guī)范的XML文檔將不能得到真確完整的顯示,如:<,>,&"",和'這些符號,當(dāng)它們在XML文件里的出現(xiàn)的時候,我們必須手工查找這些不合規(guī)范的字符;再次,當(dāng)我們需要輸出的是一個包含很多名字空間,屬性和元素的XML文件的時候,使用Response.Write()方法所必須的代碼將會變得冗長以及可讀性差。
幸運的是,.NET?FrameWork提供了一個特別為創(chuàng)建XML文件使用的類-System.Xml.XmlTextWriter,使用這個類來創(chuàng)建XML文件,你并不需要擔(dān)心輸出是否符合XML規(guī)范的問題,同時代碼將會變得非常簡潔。在這篇文章中,我們將深入的講述如何使用XmlTextWriter類來創(chuàng)建XML文件。?
關(guān)于XML的說明
這篇文章假定讀者具備一定的XML基礎(chǔ),如果你剛接觸XML,我建議你在繼續(xù)閱讀本文之前,首先去看看“什么是XML”和“XML起步”這些資料。
XmlTextWriter對象簡介:
XmlTextWriter對象包含了很多可用于在創(chuàng)建XML文件時添加元素和屬性到XML文件里的方法,比較重要的有:
WriteStartDocument()-創(chuàng)建XML文件首先就需要用到這個方法,它是在創(chuàng)建XML文件的第一行代碼,用來指定該文件是XML文件以及設(shè)置它的編碼類型;
WriteStartElement(string)-這個方法的作用是在XML文件中創(chuàng)建新元素,你可以通過String參數(shù)設(shè)置元素的名稱(當(dāng)然了,你還可以使用optional關(guān)鍵字指定一個可選的參數(shù));
WriteElementString(name,?text_value)-如果你需要創(chuàng)建一個除了字符,什么也沒有的(如不嵌套元素)的元素,你可以使用該方法;
WriteEndElement()-對應(yīng)WriteStartElement(string)方法,作為一個元素的結(jié)尾;
WriteEndDocument()-XML文件創(chuàng)建完成后使用該方法結(jié)束;
Close()-關(guān)閉所有的文本流,把創(chuàng)建的XML文件輸出到指定位置。
使用XmlTextWriter對象創(chuàng)建XML文件,需要在類構(gòu)造器中指定文件的類型,而且編碼類型必須是System.Text.Encoding,如:System.Text.Encoding.ASCII,?System.Text.Encoding.Unicode及System.Text.Encoding.UTF8,在XmlTextWriter類構(gòu)造器指定為何種類型,在輸出XML文件將以那種流文件形式輸出。
使用XmlTextWriter對象創(chuàng)建一個簡單的XML文件
接下來,我們示范一下如何使用XmlTextWriter對象來創(chuàng)建一個簡單的XML文檔,并把它保存到指定的位置,這個XML文件將包含訪問該文件的用戶的相關(guān)信息,它的輸出格式如下:
<userInfo>
<browserInfo>?
<urlReferrer>URL?referrer?info</urlReferrer>
<userAgent>User?agent?referrer?info</userAgent>
<userLanguages>languages?info</userLanguages>
</browserInfo>
<visitInfo?timeVisited="date/time?the?page?was?visited">
<ip>visitor's?IP?address</ip>
<rawUrl>raw?URL?requested</rawUrl>
</visitInfo>
</userInfo>
選用這個有這種結(jié)構(gòu)的XML文件為輸出對象,是為了可以在這里使用所有先前講過的方法,方便闡述。
如下便是創(chuàng)建該XML文件所需的ASP.NET代碼:
<%@?Import?Namespace="System.Xml"?%>
<%@?Import?Namespace="System.Text"?%>
<script?language="C#"?runat="server">
void?Page_Load(object?sender,?EventArgs?e)
{
//?Create?a?new?XmlTextWriter?instance
XmlTextWriter?writer?=?new?
XmlTextWriter(Server.MapPath("userInfo.xml"),?Encoding.UTF8);
//?start?writing!
writer.WriteStartDocument();
writer.WriteStartElement("userInfo");
//?Creating?the?<browserInfo>?element
writer.WriteStartElement("browserInfo");
if?(Request.UrlReferrer?==?null)
writer.WriteElementString("urlReferrer",?"none");
else
writer.WriteElementString("urlReferrer",?
Request.UrlReferrer.PathAndQuery);
writer.WriteElementString("userAgent",?Request.UserAgent);
writer.WriteElementString("userLanguages",?
String.Join(",?",?Request.UserLanguages));
writer.WriteEndElement();
//?Creating?the?<visitInfo>?element
writer.WriteStartElement("visitInfo");
writer.WriteAttributeString("timeVisited",?DateTime.Now.ToString());
writer.WriteElementString("ip",?Request.UserHostAddress);
writer.WriteElementString("rawUrl",?Request.RawUrl);
writer.WriteEndElement();?
writer.WriteEndElement();
writer.WriteEndDocument();
writer.Close();?
}?
首先我們要注意是否有導(dǎo)入System.Xml?and?System.Text命名空間,然后我們在Page_Load事件中創(chuàng)建一個XmlTextWriter對象實例,并且指定創(chuàng)建的XML文件保存為userInfo.xml文件和它的編碼類型為UTF8(a?translation?of?16-bit?unicode?encoding?into?8-bits),然后使用WriteStartElement(elementName)方法來創(chuàng)建嵌套了其他元素的元素,并以WriteEndElement()作為結(jié)束,此外,我們使用WriteElementString(elementName,?textValue)方法來創(chuàng)建最底層即沒有嵌套其他元素的元素。
在瀏覽器窗口中輸出XML文件
先前的例子示范了如何使用XmlTextWriter對象創(chuàng)建xml文件以及把它保存為一個文件,這個文件可能是你所需要的,但是有時候,我們需要把創(chuàng)建的XML文件在瀏覽器上顯示出來,這個時候,我們可以使用上例代碼創(chuàng)建userInfo.xml文件,然后打開它,再使用Response.Write()把它輸出,但是這種方法并不是很好。
一個好的方法是立即把XmlTextWriter對象的結(jié)果顯示在瀏覽器上,要實現(xiàn)這個功能非常地容易,只需要在上例的代碼基礎(chǔ)上修改一行代碼就可以了,在XmlTextWriter的類構(gòu)造器中,我們不指定為一個文件路徑,而是指定為Response.OutputStream,以使ASP.NET程序直接輸出XML流到瀏覽器中,而不是保存為一個文件,當(dāng)然了,你還可以設(shè)定<@?Page?...?>指令中的MIME類型為text/xml來實現(xiàn)同樣的功能,但是我建議你不要用這種方法來實現(xiàn),因為有些瀏覽器不認得該格式而把它當(dāng)做html來解釋(它將蘊藏所有的xml元素,并刪除所有的空格)。
下面列出了上例修改后的部分代碼,修改過的代碼將一些粗體顯示:
<@?Page?ContentType="text/xml"?%>
<%@?Import?Namespace="System.Xml"?%>
<%@?Import?Namespace="System.Text"?%>
<script?language="C#"?runat="server">
void?Page_Load(object?sender,?EventArgs?e)
{
//?Create?a?new?XmlTextWriter?instance
XmlTextWriter?writer?=?new?
XmlTextWriter(Response.OutputStream,?Encoding.UTF8);
//?start?writing!
...
}?
注意,盡管你訪問的是asp.net?Web頁面,但是你查看該實例所看到的僅僅是XML文檔,這個文檔跟先前創(chuàng)建的XML文件是一樣的,所不同的是,先前是保存為一個XML文件userInfo.xml。
總結(jié)
本文示范了在.NET?Framework中如何使用System.Xml.XmlTextWriter類來創(chuàng)建XML文件,XmlTextWriter對象可以創(chuàng)建一個XML文件,并把它保存到指定位置,也可以直接以指定的流形式顯示在瀏覽器上,在很多編碼工作中,使用XmlTextWriter對象構(gòu)建基于XML的程序會有很多的優(yōu)勢,其中主要有可以使代碼更加簡潔,更具可讀性,同時不用擔(dān)心輸出的XML文件是否符合規(guī)范
總結(jié)
以上是生活随笔為你收集整理的C#代码创建Xml文件的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 集市中迷失的一代:FreeBSD核心开发
- 下一篇: 从Xbox和Zune中学到的四门创业课