2010-04-20 93 views
11

我有一個C#/ WPF項目的方法,我想評論/文檔使用這樣Visual Studio的XML註釋(摘要)和特殊字符

/// <summary> 
    /// Initialises Drag & Drop 
    /// </summary> 
    void initDragDrop() 
    { 

    } 

當我現在使用的XML註釋它這個方法在我的項目的某個地方,並將鼠標懸停在它上面,我收到消息 「XML註釋包含無效的XML:在這個地方,不允許有空格」(我將結果手動翻譯爲英文,所以它可能不會在字面上你的視覺工作室)。 我發現問題是「&」的標誌,如果我刪除它,它工作正常。但是我想保留它,所以如何在XML摘要中將其轉義?我試過「\ &」,但這不起作用。

感謝您的任何提示!

回答

16

請記住,&字符在xml(實體的開始)中有特殊含義。你需要寫這樣的評論,而不是(煩人,我知道):

/// <summary> 
/// Initialises Drag &amp; Drop 
/// </summary> 
void initDragDrop() 
{ 

} 

我可能是錯在這一個點,但我不認爲你甚至可以用一個CDATA部分,以避免實體,因爲它打破了評論。您必須鍵入整個&amp;實體。

+1

其實,你可以使用CDATA。以下是我的一個項目的示例:http://kbcsv.codeplex.com/sourcecontrol/network/Show?projectName=kbcsv&changeSetId=42031#530479。另一種方法是將文檔移動到一個單獨的文件中,並將其轉入源文件中。 – 2010-04-20 16:24:38

+0

謝謝,知道的很好。 – 2010-04-20 16:26:29

+0

謝謝你們的回覆!肯特,使用你的鏈接我已經看到,你的課堂是有據可查的。我想你是從這個生成一些HTML的孩子?這個任務你使用了哪個工具?上次我查找這樣的工具,他們都是早期的網絡版本,或者很難用於初學者。 我會接受joels的答案,首先它是一個簡短的解決方案,第二個肯特添加他的解決方案作爲評論這是不可標註的,否則我也會標記它;-) – 2010-04-20 16:40:31