DebuggerTypeProxyAttribute Classe

Définition

public ref class DebuggerTypeProxyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=true)]
public sealed class DebuggerTypeProxyAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=true)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DebuggerTypeProxyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=true)>]
type DebuggerTypeProxyAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=true)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DebuggerTypeProxyAttribute = class
    inherit Attribute

Public NotInheritable Class DebuggerTypeProxyAttribute
Inherits Attribute

Héritage

Object

Attribute

DebuggerTypeProxyAttribute

Attributs

AttributeUsageAttribute ComVisibleAttribute

Exemples

L’exemple de code suivant montre l’utilisation du DebuggerTypeProxyAttribute type imbriqué privé à utiliser comme proxy d’affichage du débogueur. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DebuggerDisplayAttribute classe.

[DebuggerTypeProxy(typeof(HashtableDebugView))]
class MyHashtable : Hashtable
{
    private const string TestString = "This should not appear in the debug window.";

    internal class HashtableDebugView
    {
        private Hashtable hashtable;
        public const string TestString = "This should appear in the debug window.";
        public HashtableDebugView(Hashtable hashtable)
        {
            this.hashtable = hashtable;
        }

        [DebuggerBrowsable(DebuggerBrowsableState.RootHidden)]
        public KeyValuePairs[] Keys
        {
            get
            {
                KeyValuePairs[] keys = new KeyValuePairs[hashtable.Count];

                int i = 0;
                foreach(object key in hashtable.Keys)
                {
                    keys[i] = new KeyValuePairs(hashtable, key, hashtable[key]);
                    i++;
                }
                return keys;
            }
        }
    }
}

<DebuggerDisplay("Count = {Count}"), DebuggerTypeProxy(GetType(MyHashtable.HashtableDebugView))> _
Class MyHashtable
    Inherits Hashtable
    Private Const TestString As String = "This should not appear in the debug window."

    Friend Class HashtableDebugView
        Private hashtable As Hashtable
        Public Shared TestString As String = "This should appear in the debug window."

        Public Sub New(ByVal hashtable As Hashtable)
            Me.hashtable = hashtable
        End Sub

        <DebuggerBrowsable(DebuggerBrowsableState.RootHidden)> _
        ReadOnly Property Keys as KeyValuePairs()
            Get
                Dim nkeys(hashtable.Count) as KeyValuePairs

                Dim i as Integer = 0
                For Each key As Object In hashtable.Keys
                    nkeys(i) = New KeyValuePairs(hashtable, key, hashtable(key))
                    i = i + 1
                Next
                Return nkeys
            End Get
        End Property

    End Class
End Class

Remarques

Note Utilisez cet attribut lorsque vous devez modifier considérablement et fondamentalement la vue de débogage d’un type, mais ne modifiez pas le type lui-même.

L’attribut DebuggerTypeProxyAttribute est utilisé pour spécifier un proxy d’affichage pour un type, ce qui permet à un développeur d’adapter la vue pour le type. Cet attribut peut également être utilisé au niveau de l’assembly, auquel cas la Target propriété spécifie le type pour lequel le proxy sera utilisé. En général, cet attribut spécifie un type imbriqué privé qui se produit dans le type auquel l’attribut est appliqué. Évaluateur d’expression qui prend en charge les visionneuses de types vérifie cet attribut lorsqu’un type est affiché. Si l’attribut est trouvé, l’évaluateur d’expression remplace le type auquel l’attribut est appliqué par le type de proxy d’affichage.

Lorsque DebuggerBrowsableAttribute est présent, la fenêtre des variables du débogueur affiche uniquement les membres publics du type proxy. Les membres privés ne sont pas affichés. Le comportement de la fenêtre de données n’est pas modifié par les vues améliorées par attribut.

Pour éviter les pénalités de performances inutiles, les évaluateurs d’expression ne doivent pas examiner les attributs sur le proxy d’affichage du type, sauf si le type est développé, soit via l’utilisateur qui clique sur le signe plus (+) en regard du type dans une fenêtre de données, soit via l’application de l’attribut DebuggerBrowsableAttribute . Par conséquent, il est recommandé qu’aucun attribut ne soit appliqué au type d’affichage. Les attributs peuvent et doivent être appliqués dans le corps du type d’affichage.

Voir aussi

• À l’aide de l’attribut DebuggerTypeProxy