新聞中心
雖然有許多人對(duì)VS XML注釋的插件表示懷疑,但在年復(fù)一年的不斷發(fā)展中,他的插件問題也在不斷提高。保障VS XML注釋的插件穩(wěn)定運(yùn)行是完全有可能的,但前提是要深入理解到底什么是VS XML注釋,及他是怎么運(yùn)作的。

專注于為中小企業(yè)提供做網(wǎng)站、成都網(wǎng)站建設(shè)服務(wù),電腦端+手機(jī)端+微信端的三站合一,更高效的管理,為中小企業(yè)石景山免費(fèi)做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都,凝聚了一批互聯(lián)網(wǎng)行業(yè)人才,有力地推動(dòng)了上千企業(yè)的穩(wěn)健成長,幫助中小企業(yè)通過網(wǎng)站建設(shè)實(shí)現(xiàn)規(guī)模擴(kuò)充和轉(zhuǎn)變。
這些手工標(biāo)記是非常有用的,如果恰當(dāng)?shù)卦O(shè)置他們,對(duì)導(dǎo)出成外部說明文件將非常有幫助。如果碰到是預(yù)先定義的xml標(biāo)記,編譯器可以把這些注釋以文本輸出;如果是編譯器不認(rèn)識(shí)的xml標(biāo)記,編譯器會(huì)逐字的把所有內(nèi)容都輸出,這意味著你可以使用自己定義的標(biāo)記。#t#
適當(dāng)?shù)脑O(shè)置,C#編譯器并不格式化VS XML注釋,而是以xml文件輸出。下面的步驟將演示如何讓C#編譯器把VS XML注釋輸出為xml文件。右鍵點(diǎn)擊解決方案資源管理器中的工程項(xiàng),打開工程的屬性頁,點(diǎn)擊屬性。對(duì)話框出現(xiàn)后,點(diǎn)擊配置屬性目錄。點(diǎn)擊生成節(jié)點(diǎn)。
在右邊的框中有輸出--xml文檔文件,這里就是設(shè)置叢VS XML注釋生成xml文件的文件名。(注:這里設(shè)置的是相對(duì)路徑,不是絕對(duì)路徑)。在我的例子中,我使用GiveHelpDoc.xml作為文檔名,如果這里沒有輸入任何值,這將是默認(rèn)設(shè)置。
公認(rèn)的標(biāo)記我把VS XML注釋標(biāo)記分類兩大類:***類是設(shè)置標(biāo)記,我叫他們主標(biāo)記。他們?cè)谝唤M標(biāo)記的開始,而且不會(huì)在標(biāo)記內(nèi)部出現(xiàn)。第二類是設(shè)置標(biāo)記包含的標(biāo)記,我叫他們支持標(biāo)記。支持標(biāo)記和html標(biāo)記的區(qū)別在于:支持標(biāo)記采用的是小寫,html標(biāo)記采用的是大寫,顯示了我將要討論的支持標(biāo)記和主標(biāo)記。
GiveHelpTransforms.cs部分代碼:
- namespace GiveHelp
- {
- Class that contains functions to do transformations to help files.
- The source XML is loaded into the
cref="SourceXML"/> property - (e.g.
obj.SourceXML = "XML goes here"). One of - the associated member functions (
cref="GiveTypeListHTMLHelp"/ - >,
cref="GiveMemberListHTMLHelp"/>, - cref="GiveMemberHTMLHelp"/>)
- is called to initiate and then return the transformation.
type="table">
Help Page Function to call - List of Types
GiveTypeListHTMLHelp - List of members
GiveMemberListHTMLHelp - Help for a single member
GiveMemberHTMLHelp cref="">public - // create the class that does translations
- GiveHelpTransforms ght = new GiveHelpTransforms();
- // have it load our XML into the SourceXML property
- ght.LoadXMLFromFile("E:\\Inetpub\\www-
- root\\GiveHelp\\GiveHelpDoc.xml");
- // do the translation and then write out the string
- Response.Write( ght.
- GiveMemberHTMLHelp(Request.QueryString.Get("Type"),
- Request.QueryString.Get("Member")) );
- public class GiveHelpTransforms
- {
新聞名稱:解釋說明VSXML注釋插件常見問題
分享網(wǎng)址:http://www.5511xx.com/article/djhjgih.html


咨詢
建站咨詢
