DebuggerTypeProxyAttribute Класс

Определение

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

Наследование

Object

Attribute

DebuggerTypeProxyAttribute

Атрибуты

AttributeUsageAttribute ComVisibleAttribute

Примеры

В следующем примере кода показано, DebuggerTypeProxyAttribute как указать частный вложенный тип, который будет использоваться в качестве прокси-сервера отображения отладчика. Этот пример кода является частью более крупного примера, предоставленного для DebuggerDisplayAttribute класса.

[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

Комментарии

Примечание Используйте этот атрибут, если необходимо значительно и принципиально изменить представление отладки типа, но не измените сам тип.

Атрибут DebuggerTypeProxyAttribute используется для указания прокси-сервера отображения для типа, что позволяет разработчику адаптировать представление для типа. Этот атрибут также можно использовать на уровне сборки, в этом случае Target свойство указывает тип, для которого будет использоваться прокси-сервер. Как правило, этот атрибут указывает частный вложенный тип, который возникает в пределах типа, к которому применяется атрибут. Средство оценки выражений, поддерживающее средства просмотра типов, проверяет наличие этого атрибута при отображении типа. Если атрибут найден, средство оценки выражений заменяет тип прокси отображения для типа, к которому применяется атрибут.

Когда присутствует DebuggerBrowsableAttribute, окно переменных отладчика отображает только публичные члены типа прокси. Приватные члены не отображаются. Поведение окна данных не изменяется с помощью расширенных атрибутов представлений.

Чтобы избежать ненужных штрафов производительности, вычислители выражений не должны проверять атрибуты на отображаемом прокси-сервере типа, если тип не развернут, либо через пользователя, щелкнув знак плюса (+) рядом с типом в окне данных, либо с помощью приложения атрибута DebuggerBrowsableAttribute . Поэтому рекомендуется не применять атрибуты к типу отображения. Атрибуты могут и должны применяться в рамках типа отображения.

См. также раздел

• Использование атрибута DebuggerTypeProxy