ASP.NET MVC控制器的註釋默認格式

Question

有人可以解釋ASP.NET MVC控制器的格式嗎？他們看起來像這樣：

public class ProductsController : Controller 
{ 
    // 
    // GET: /Products/Edit/34 

    public ActionResult Edit(int id) 
    { 
     // ... 
    } 
} 

他們爲什麼不遵循三條斜線和XML標記標準的C＃-notation？爲什麼評論和方法之間的空行？

我我oppinion它應該看起來有些像這樣：

public class ProductsController : Controller 
{ 
    /// <remarks> 
    /// GET: /Products/Edit/34 
    /// </remarks> 
    public ActionResult Edit(int id) 
    { 
     // ... 
    } 
} 

Answer 1

我只是猜測，但您指定的格式不是用於註釋，而是用於內聯文檔。你有能力修改T4模板來獲得你喜歡的編碼風格。

Answer 2

我想這則留言的作者不希望它被包含組件的文檔。

Answer 3

這些是爲編寫代碼的人編寫的，而不是爲調用控制器方法的人寫的（可能沒有人會直接調用它）。

此外，文檔註釋意味着客觀性和/Products/Edit/34不是一個正式的描述 - 它取決於路線。