DebuggerTypeProxyAttribute Třída

Definice

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

Dědičnost

Object

Attribute

DebuggerTypeProxyAttribute

Atributy

AttributeUsageAttribute ComVisibleAttribute

Příklady

Následující příklad kódu ukazuje použití k určení privátního DebuggerTypeProxyAttribute vnořeného typu, který se má použít jako proxy zobrazení ladicího programu. Tento příklad kódu je součástí většího příkladu DebuggerDisplayAttribute pro třídu .

[DebuggerTypeProxy(HashtableDebugView::typeid)]
ref class MyHashtable : Hashtable
{
private:
    static const String^ TestString = "This should not appear in the debug window.";

internal:
    ref class HashtableDebugView
    {
    private:
        Hashtable^ hashtable;
    public:
        static const String^ TestString = "This should appear in the debug window.";
        HashtableDebugView(Hashtable^ hashtable)
        {
            this->hashtable = hashtable;
        }

        [DebuggerBrowsable(DebuggerBrowsableState::RootHidden)]
        property array<KeyValuePairs^>^ Keys
        {
            array<KeyValuePairs^>^ get()
            {
                array<KeyValuePairs^>^ keys = gcnew array<KeyValuePairs^>(hashtable->Count);

                IEnumerator^ ie = hashtable->Keys->GetEnumerator();
                int i = 0;
                Object^ key;
                while (ie->MoveNext())
                {
                    key = ie->Current;
                    keys[i] = gcnew KeyValuePairs(hashtable, key, hashtable[key]);
                    i++;
                }
                return keys;
            }
        }
    };
};

[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

Poznámky

Poznámka Tento atribut použijte, když potřebujete výrazně a zásadně změnit zobrazení ladění typu, ale ne změnit samotný typ.

Atribut DebuggerTypeProxyAttribute slouží k určení proxy zobrazení pro typ, což vývojáři umožňuje přizpůsobit zobrazení pro typ. Tento atribut lze použít také na úrovni sestavení. V takovém případě Target vlastnost určuje typ, pro který bude proxy server použit. Obecně platí, že tento atribut určuje privátní vnořený typ, který se vyskytuje v rámci typu, na který je atribut použit. Vyhodnocovače výrazů, které podporují prohlížeče typů, kontroluje tento atribut při zobrazení typu. Pokud se atribut najde, vyhodnocovací nástroj výrazu nahradí typ zobrazovaných proxy pro typ, na který se atribut použije.

DebuggerBrowsableAttribute Pokud je k dispozici, okno proměnné ladicího programu zobrazí pouze veřejné členy typu proxy. Soukromé členy se nezobrazují. Zobrazení s rozšířenými atributy nezmění chování datového okna.

Aby se zabránilo zbytečným sankcím za výkon, neměly by vyhodnocovače výrazů zkoumat atributy na proxy zobrazení typu, pokud není typ rozbalený, a to buď kliknutím uživatele na znaménko plus (+) vedle typu v datovém okně, nebo prostřednictvím použití atributu DebuggerBrowsableAttribute . Proto se doporučuje, aby se na typ zobrazení nepoužádly žádné atributy. Atributy mohou a měly by být použity v těle typu zobrazení.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• Používání atributu DebuggerTypeProxy