DebuggerTypeProxyAttribute DebuggerTypeProxyAttribute DebuggerTypeProxyAttribute DebuggerTypeProxyAttribute Class

Definition

Gibt den Anzeigeproxy für einen Typ an.Specifies the display proxy for a type.

public ref class DebuggerTypeProxyAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=true)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DebuggerTypeProxyAttribute : Attribute
type DebuggerTypeProxyAttribute = class
    inherit Attribute
Public NotInheritable Class DebuggerTypeProxyAttribute
Inherits Attribute
Vererbung
DebuggerTypeProxyAttributeDebuggerTypeProxyAttributeDebuggerTypeProxyAttributeDebuggerTypeProxyAttribute
Attribute

Beispiele

Im folgenden Codebeispiel DebuggerTypeProxyAttribute wird veranschaulicht, wie der verwendet wird, um einen privaten, als Debugger-Anzeige Proxy zu verwendenden privaten Typ anzugeben.The following code example shows the use of the DebuggerTypeProxyAttribute to specify a private nested type to be used as a debugger display proxy. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DebuggerDisplayAttribute -Klasse bereitgestellt wird.This code example is part of a larger example provided for the DebuggerDisplayAttribute class.

[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 'New

        <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 'HashtableDebugView
End Class 'MyHashtable

Hinweise

Hinweis Verwenden Sie dieses Attribut, wenn Sie die debuggingansicht eines Typs erheblich und grundlegend ändern müssen, ohne den Typ selbst zu ändern.Note Use this attribute when you need to significantly and fundamentally change the debugging view of a type, but not change the type itself.

Das DebuggerTypeProxyAttribute-Attribut wird verwendet, um einen Anzeigeproxy für einen Typ anzugeben. Dadurch wird es einem Entwickler ermöglicht, die Ansicht des Typs anzupassen.The DebuggerTypeProxyAttribute attribute is used to specify a display proxy for a type, allowing a developer to tailor the view for the type. Dieses Attribut kann auch auf Assemblyebene verwendet werden. in diesem Fall gibt Target die-Eigenschaft den Typ an, für den der Proxy verwendet wird.This attribute can be used at the assembly level as well, in which case the Target property specifies the type for which the proxy will be used. Im Allgemeinen gibt dieses Attribut einen privaten geschachtelten Typ an, der innerhalb des Typs auftritt, auf den das Attribut angewendet wird.In general, this attribute specifies a private nested type that occurs within the type to which the attribute is applied. Eine Ausdrucksauswertung, die Überprüfungen für die Ansichten von Typen für dieses Attribut unterstützt, wenn ein Typ angezeigt wird.An expression evaluator that supports type viewers checks for this attribute when a type is displayed. Wenn das Attribut gefunden wird, ersetzt die Ausdrucksauswertung den Anzeigeproxytyp für den Typ, auf den das Attribut angewendet wird.If the attribute is found, the expression evaluator substitutes the display proxy type for the type the attribute is applied to.

Wenn DebuggerBrowsableAttribute vorhanden ist, werden im Debuggervariablenfenster nur die öffentlichen Member des Proxytyps angezeigt.When the DebuggerBrowsableAttribute is present, the debugger variable window displays only the public members of the proxy type. Private Member werden nicht angezeigt.Private members are not displayed. Das Verhalten des Datenfensters wird durch von Attributen erweiterte Ansichten nicht verändert.The behavior of the data window is not changed by attribute-enhanced views.

Um unnötige Leistungseinbußen zu vermeiden, sollten Ausdrucksauswertungen die Attribute des Anzeige Proxys des Typs nicht untersuchen, es sei denn, der Typ wird erweitert, entweder durch den Benutzer, indem Sie auf das Pluszeichen (+) neben dem Typ in einem Datenfenster klicken, oder über das die DebuggerBrowsableAttribute Anwendung des Attributs.To avoid unnecessary performance penalties, expression evaluators should not examine the attributes on the display proxy of the type unless the type is expanded, either through the user clicking the plus sign (+) next to the type in a data window, or through the application of the DebuggerBrowsableAttribute attribute. Aus diesem Grund wird empfohlen, keine Attribute auf den Anzeigetyp anzuwenden.Therefore, it is recommended that no attributes be applied to the display type. Attribute können und sollen im Text des Anzeigetyps angewendet werden.Attributes can and should be applied within the body of the display type.

Konstruktoren

DebuggerTypeProxyAttribute(String) DebuggerTypeProxyAttribute(String) DebuggerTypeProxyAttribute(String) DebuggerTypeProxyAttribute(String)

Initialisiert eine neue Instanz der DebuggerTypeProxyAttribute-Klasse unter Verwendung des Typnamens des Proxys.Initializes a new instance of the DebuggerTypeProxyAttribute class using the type name of the proxy.

DebuggerTypeProxyAttribute(Type) DebuggerTypeProxyAttribute(Type) DebuggerTypeProxyAttribute(Type) DebuggerTypeProxyAttribute(Type)

Initialisiert eine neue Instanz der DebuggerTypeProxyAttribute-Klasse unter Verwendung des Proxytyps.Initializes a new instance of the DebuggerTypeProxyAttribute class using the type of the proxy.

Eigenschaften

ProxyTypeName ProxyTypeName ProxyTypeName ProxyTypeName

Ruft den Typnamen des Proxytyps ab.Gets the type name of the proxy type.

Target Target Target Target

Ruft den Zieltyp für das Attribut ab oder legt dieses fest.Gets or sets the target type for the attribute.

TargetTypeName TargetTypeName TargetTypeName TargetTypeName

Ruft den Namen des Zieltyps ab oder legt diesen fest.Gets or sets the name of the target type.

TypeId TypeId TypeId TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Gilt für:

Siehe auch