在C#XML文档中记录属性的使用
我尝试使用XML注释和doxygen记录以下C#代码: /控制器/FooController.cs在C#XML文档中记录属性的使用,c#,attributes,documentation,doxygen,C#,Attributes,Documentation,Doxygen,我尝试使用XML注释和doxygen记录以下C#代码: /控制器/FooController.cs 使用System.Web.Mvc; 使用WebApplication.Attributes; 使用WebApplication.Models; 命名空间WebApplication.Controllers { /// ///用于/Foo的ASP.NET MVC控制器/ /// ///访问权限仅限于整个控制器。 /// /// [验证第三方会话] 公共类控制器:控制器 { //废话 } }
使用System.Web.Mvc;
使用WebApplication.Attributes;
使用WebApplication.Models;
命名空间WebApplication.Controllers
{
///
///用于/Foo的ASP.NET MVC控制器/
///
///访问权限仅限于整个控制器。
///
///
[验证第三方会话]
公共类控制器:控制器
{
//废话
}
}
属性定义位于/Attributes/validateHirdPartySessionAttribute.cs中,其全名为WebApplication.Attributes.validateHirdPartySessionAttribute
当运行doxygen时,cref
不会链接或拾取ValidateThirdpartySessionAttribute
类。我还尝试了ValidateThirdPartySession
和它的全名,但什么也认不出来
作为一个侧节点(可能相关),我正在使用VisualStudio2010,“编译器检查给定的代码元素是否存在”。即使我将
cref
更改为gibberish,也不会发出警告。是否尝试使用包含命名空间的完整类名?是的,我尝试过ValidateHirdPartySession、ValidateHirdPartySessionAttribute和WebApplication.Attributes.ValidateHirdPartySessionAttribute。
using System.Web.Mvc;
using WebApplication.Attributes;
using WebApplication.Models;
namespace WebApplication.Controllers
{
/// <summary>
/// ASP.NET MVC controller for /Foo/
/// <para>
/// Access is limited via <see cref="ValidateThirdPartySessionAttribute"/> to the entire controller.
/// </para>
/// </summary>
[ValidateThirdPartySession]
public class FooController : Controller
{
// blah
}
}