XML コメントと doxygen を使用して文書化しようとしている次の C# コードがあります。
/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 は「指定されたコード要素が存在することをコンパイラがチェックする」と主張してい ます。意味不明に変更しても、警告は表示されません。cref