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

專注于為中小企業(yè)提供做網(wǎng)站、成都網(wǎng)站建設(shè)服務(wù),電腦端+手機端+微信端的三站合一,更高效的管理,為中小企業(yè)石景山免費做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都,凝聚了一批互聯(lián)網(wǎng)行業(yè)人才,有力地推動了上千企業(yè)的穩(wěn)健成長,幫助中小企業(yè)通過網(wǎng)站建設(shè)實現(xiàn)規(guī)模擴充和轉(zhuǎn)變。
這些手工標記是非常有用的,如果恰當?shù)卦O(shè)置他們,對導出成外部說明文件將非常有幫助。如果碰到是預先定義的xml標記,編譯器可以把這些注釋以文本輸出;如果是編譯器不認識的xml標記,編譯器會逐字的把所有內(nèi)容都輸出,這意味著你可以使用自己定義的標記。#t#
適當?shù)脑O(shè)置,C#編譯器并不格式化VS XML注釋,而是以xml文件輸出。下面的步驟將演示如何讓C#編譯器把VS XML注釋輸出為xml文件。右鍵點擊解決方案資源管理器中的工程項,打開工程的屬性頁,點擊屬性。對話框出現(xiàn)后,點擊配置屬性目錄。點擊生成節(jié)點。
在右邊的框中有輸出--xml文檔文件,這里就是設(shè)置叢VS XML注釋生成xml文件的文件名。(注:這里設(shè)置的是相對路徑,不是絕對路徑)。在我的例子中,我使用GiveHelpDoc.xml作為文檔名,如果這里沒有輸入任何值,這將是默認設(shè)置。
公認的標記我把VS XML注釋標記分類兩大類:***類是設(shè)置標記,我叫他們主標記。他們在一組標記的開始,而且不會在標記內(nèi)部出現(xiàn)。第二類是設(shè)置標記包含的標記,我叫他們支持標記。支持標記和html標記的區(qū)別在于:支持標記采用的是小寫,html標記采用的是大寫,顯示了我將要討論的支持標記和主標記。
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
- {
網(wǎng)頁名稱:解釋說明VSXML注釋插件常見問題
網(wǎng)站URL:http://m.fisionsoft.com.cn/article/djhjgih.html


咨詢
建站咨詢
