当前位置:  开发笔记 > 编程语言 > 正文

XML注释中的filterpriority标记有什么作用?

如何解决《XML注释中的filterpriority标记有什么作用?》经验,为你挑选了2个好方法。

我已经在.NET Framework BCL中的类的许多XML注释中看到了这一点,但是从来没有找到解释它的功能的文档.

例如,查看System.Object会显示以下注释:

namespace System   
{
    /// Supports all classes in the .NET Framework class hierarchy 
    /// and provides low-level services to derived classes. This is the 
    /// ultimate base class of all classes in the .NET Framework; it is the
    /// root of the type hierarchy.
    /// 1 
    [System.Runtime.InteropServices.ClassInterfaceAttribute(2)]
    public class Object    
    {    
        /// Determines whether the specified 
        ///  
        /// instances are considered equal.  
        /// true if objA is the same instance as objB or
        /// if both are null
        /// references or if objA.Equals(objB) returns true; 
        /// otherwise, false.
        /// The second  
        /// to compare. 
        /// The first  
        /// to compare. 
        /// 2
        public static bool Equals(object objA, object objB);
     }
 }

Joel Coehoor.. 16

只是一个猜测:intellisense中的All vs Common选项卡?



1> Joel Coehoor..:

只是一个猜测:intellisense中的All vs Common选项卡?


好的...博客文章位于:http://geekswithblogs.net/sdorman/archive/2009/01/08/xml-comments-filterpriority.aspx
原来你是对的,这是一个仅VB的功能.filterpriority = 2与EditorBrowsable(EditorBrowsableState.Advanced)等价,并且该方法仅显示在"All"选项卡上.您需要生成一个XML注释文件才能使其生效.C#似乎忽略了评论.
您和Øyvind的评论与http://issuu.com/pchew/docs/xml_document_guide/31相关联.在VB和C#项目中添加了一些实际测试,让我完成剩下的工作.在撰写关于此的完整博客文章的过程中.完成后会发布链接.

2> Øyvind Skaar..:

它与使用EditorBrowsableAttribute装饰您的成员相同.我猜测值0,1和2对应于Always,Advanced和Never.


事实证明Joel是正确的,并且这确定了该方法在VB.NET中显示的“智能”选项卡。您也是正确的,因为它在智能感知上提供了与EditorBrowsable(EditorBrowsableState.Advanced)属性相同的行为。
推荐阅读
可爱的天使keven_464
这个屌丝很懒,什么也没留下!
DevBox开发工具箱 | 专业的在线开发工具网站    京公网安备 11010802040832号  |  京ICP备19059560号-6
Copyright © 1998 - 2020 DevBox.CN. All Rights Reserved devBox.cn 开发工具箱 版权所有