DebuggerTypeProxyAttribute DebuggerTypeProxyAttribute DebuggerTypeProxyAttribute DebuggerTypeProxyAttribute Class

Определение

Указывает прокси-тип отображения для типа.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
Наследование
DebuggerTypeProxyAttributeDebuggerTypeProxyAttributeDebuggerTypeProxyAttributeDebuggerTypeProxyAttribute
Атрибуты

Примеры

В следующем примере кода показано использование DebuggerTypeProxyAttribute для указания закрытый вложенный тип для использования в качестве прокси-тип отображения отладчика.The following code example shows the use of the DebuggerTypeProxyAttribute to specify a private nested type to be used as a debugger display proxy. Данный пример кода является частью большего примера для DebuggerDisplayAttribute класса.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

Комментарии

Примечание этот атрибут используется, когда требуется существенным образом изменить представление отладки для типа, но не изменять сам тип.Note Use this attribute when you need to significantly and fundamentally change the debugging view of a type, but not change the type itself.

Атрибут DebuggerTypeProxyAttribute задает прокси-тип отображения для типа, позволяя разработчику настроить представление этого типа.The DebuggerTypeProxyAttribute attribute is used to specify a display proxy for a type, allowing a developer to tailor the view for the type. Этот атрибут можно использовать на уровне сборки, в этом случае Target свойство задает тип, для которого будет использоваться прокси-сервер.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. Как правило этот атрибут задает закрытый вложенный тип, входящего в тип, к которому применяется атрибут.In general, this attribute specifies a private nested type that occurs within the type to which the attribute is applied. При отображении типа вычислитель выражений, поддерживающий средства просмотра типов, проверяет наличие этого атрибута.An expression evaluator that supports type viewers checks for this attribute when a type is displayed. Если он найден, вычислитель выражений заменяет прокси-тип отображения на тип, к которому применен этот атрибут.If the attribute is found, the expression evaluator substitutes the display proxy type for the type the attribute is applied to.

Если атрибут DebuggerBrowsableAttribute задан, окно переменных отладчика отображает только открытые члены прокси-типа.When the DebuggerBrowsableAttribute is present, the debugger variable window displays only the public members of the proxy type. Закрытые члены не отображаются.Private members are not displayed. При использовании атрибутов просмотра поведение окна данных не изменяется.The behavior of the data window is not changed by attribute-enhanced views.

Во избежание потери производительности, вычислители выражений должен не проверяет атрибуты при отображении прокси-тип, если тип не будет развернут, либо через пользователя, щелкнув знак плюса (+) рядом с типом в окне данных или с помощью приложения из DebuggerBrowsableAttribute атрибута.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. В связи с этим не рекомендуется применять атрибуты к типам отображения.Therefore, it is recommended that no attributes be applied to the display type. Атрибуты можно и нужно применять в основной части типа отображения.Attributes can and should be applied within the body of the display type.

Конструкторы

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

Инициализирует новый экземпляр класса DebuggerTypeProxyAttribute, используя указанное имя прокси-типа.Initializes a new instance of the DebuggerTypeProxyAttribute class using the type name of the proxy.

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

Инициализирует новый экземпляр класса DebuggerTypeProxyAttribute, используя указанный прокси-тип.Initializes a new instance of the DebuggerTypeProxyAttribute class using the type of the proxy.

Свойства

ProxyTypeName ProxyTypeName ProxyTypeName ProxyTypeName

Возвращает имя прокси-типа.Gets the type name of the proxy type.

Target Target Target Target

Возвращает или задает для атрибута тип целевого объекта.Gets or sets the target type for the attribute.

TargetTypeName TargetTypeName TargetTypeName TargetTypeName

Возвращает или задает имя типа целевого объекта.Gets or sets the name of the target type.

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Методы

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

Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

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

Возвращает хэш-код для данного экземпляра.Returns the hash code for this instance.

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

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса.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)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.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()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

_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)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.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)

Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса.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)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 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)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Применяется к

Дополнительно