记录C#XML文档中属性的使用

时间:2012-10-05 11:02:54

标签: c# attributes documentation doxygen

我有以下C#代码,我试图使用XML注释和doxygen来记录:

/Controllers/FooController.cs

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
    }
}

属性定义位于 /Attributes/ValidateThirdPartySessionAttribute.cs 中,其全名为WebApplication.Attributes.ValidateThirdPartySessionAttribute

在通过doxygen运行时cref没有链接到或接收ValidateThirdpartySessionAttribute类。我也尝试了ValidateThirdPartySession及其全名,但没有人认出来。

作为一个副节点(可能是相关的),我正在使用Visual Studio 2010,MSDN claims that “编译器会检查给定的代码元素是否存在”。即使我将cref更改为乱码,也不会发出任何警告。

0 个答案:

没有答案