À quoi sert la balise filterpriority dans un commentaire XML?
-
07-07-2019 - |
Question
J'ai vu cela dans de nombreux commentaires XML pour les classes du .NET Framework BCL, mais je n'ai jamais trouvé de documentation qui explique ce qu'il fait.
À titre d'exemple, l'examen de System.Object révèle les commentaires suivants:
namespace System
{
/// <summary>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.</summary>
/// <filterpriority>1</filterpriority>
[System.Runtime.InteropServices.ClassInterfaceAttribute(2)]
public class Object
{
/// <summary>Determines whether the specified
/// <see cref="T:System.Object" />
/// instances are considered equal.</summary>
/// <returns>true if objA is the same instance as objB or
/// if both are null
/// references or if objA.Equals(objB) returns true;
/// otherwise, false.</returns>
/// <param name="objB">The second <see cref="T:System.Object" />
/// to compare. </param>
/// <param name="objA">The first <see cref="T:System.Object" />
/// to compare. </param>
/// <filterpriority>2</filterpriority>
public static bool Equals(object objA, object objB);
}
}
La solution
Juste une supposition: les onglets Tous vs Communs dans intellisense?
Autres conseils
Cela revient à décorer votre membre avec EditorBrowsableAttribute. Je suppose que les valeurs 0,1 et 2 correspondent à Toujours, Avancé et Jamais.
Licencié sous: CC-BY-SA avec attribution
Non affilié à StackOverflow