2010-07-06 138 views
6

有沒有人知道是否有一個XSD文件可用於驗證在使用/ doc選項編譯C#項目時生成的XML文檔?XSD爲C#生成的XML文檔?

我想在生成它之後手動修改該文件,並且正在尋找一種簡單的方法來確認我沒有損壞該文件的結構。

謝謝。

+0

並不嚴格回答你的問題,但這裏的[推薦的標籤列表(http://msdn.microsoft.com/en-us/library/5ast78ax。 aspx)鏈接到使用示例。注意:您可以在頁面上選擇適用的Visual Studio版本。 – Steven 2014-05-20 18:37:33

回答

2

今天偶然發現了這個老問題。我沒有看到微軟的文檔,也沒有看到其他項目,我認爲可能有興趣開發這樣的模式;即Sandcastle和(長期停用)NDoc項目的來源。

由於缺乏嘗試自行定義模式的問題,我可以建議的一件事就是使用將從XML生成XSD的許多工具之一。微軟將XSD.EXE作爲Visual Studio及其SDK的一部分。

您可以編寫虛擬源,練習每個XML文檔註釋標記,爲其構建XML文檔文件,然後使用XSD.EXE。從中生成XSD,並在處理完成後使用它來驗證XML文檔。但我認爲這可能會變得不那麼微不足道。另外,XML文檔註釋涉及類型和代碼元素,並且模式不會捕捉到很多東西;例如,驗證<param>標記的name屬性是否仍引用C#源代碼中的實際參數名稱。編譯器在構建時驗證這些元素。但是,如果您後處理XML文檔,則需要一個自定義工具,該工具引用了原始C#源代碼或生成的程序集來重新驗證此類引用。

8

我終於崩潰了,寫了一個:XSD for Xml Comments for .NET Documentation

+0

我知道這是一箇舊的答案,但我試圖找到有關成員元素名稱屬性格式的文檔。我看到了正則表達式,但正在尋找關於如何解釋這個問題的文檔。 – Jeremy 2013-11-13 21:14:31