DebuggerTypeProxyAttribute Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Runtime.dll

Zdroj:

DebuggerTypeProxyAttribute.cs

Určuje zástupné zobrazení typu.

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)>]
type DebuggerTypeProxyAttribute = class
    inherit Attribute

Public NotInheritable Class DebuggerTypeProxyAttribute
Inherits Attribute

Dědičnost

Object

Attribute

DebuggerTypeProxyAttribute

Atributy

AttributeUsageAttribute

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

DebuggerTypeProxyAttribute(String)	Inicializuje novou instanci DebuggerTypeProxyAttribute třídy pomocí názvu typu proxy.
DebuggerTypeProxyAttribute(Type)	Inicializuje novou instanci DebuggerTypeProxyAttribute třídy pomocí typu proxy.

Vlastnosti

ProxyTypeName	Získá název typu proxy.
Target	Získá nebo nastaví typ cíle pro atribut.
TargetTypeName	Získá nebo nastaví název cílového typu.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Používání atributu DebuggerTypeProxy