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不是一个正式的描述 - 它取决于路线。