DebuggerTypeProxyAttribute 類別

定義

命名空間:

System.Diagnostics

組件:

System.Runtime.dll

來源:

DebuggerTypeProxyAttribute.cs

指定類型的顯示 Proxy。

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

繼承

Object

Attribute

DebuggerTypeProxyAttribute

屬性

AttributeUsageAttribute

範例

下列程式代碼範例示範如何使用 DebuggerTypeProxyAttribute 來指定要作為調試程序顯示 Proxy 的私人巢狀類型。 此程式代碼範例是針對 類別提供的較大範例的 DebuggerDisplayAttribute 一部分。

[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

備註

注意 當您需要大幅且基本上變更類型的偵錯檢視時，請使用這個屬性，但不會變更類型本身。

DebuggerTypeProxyAttribute 屬性用來指定類型的顯示 Proxy，讓開發人員調整類型的檢視。 這個屬性也可以用於元件層級，在此情況下， Target 屬性會指定要使用 Proxy 的類型。 一般而言，這個屬性會指定套用屬性之型別內發生的私用巢狀類型。 顯示類型時，支援類型檢視器的運算式評估工具會檢查這個屬性。 如果找到屬性，運算式評估工具會用顯示 Proxy 類型替代套用屬性的類型。

當 DebuggerBrowsableAttribute 出現時，偵錯工具變數視窗只會顯示 Proxy 類型的 Public 成員。 私用成員不會顯示。 屬性增強的檢視不會變更資料視窗的行為。

為避免不必要的效能負面影響，除非展開類型，否則表達式評估工具不應該檢查類型顯示 Proxy 上的屬性，不論是透過使用者按兩下資料視窗中類型旁的加號 (+) ，或透過屬性的應用程式 DebuggerBrowsableAttribute 。 因此，顯示類型不建議套用任何屬性。 屬性可以而且應該套用在顯示類型的主體中。

建構函式

DebuggerTypeProxyAttribute(String)	使用 Proxy 的型別名稱，初始化 DebuggerTypeProxyAttribute 類別的新執行個體。
DebuggerTypeProxyAttribute(Type)	使用 Proxy 的型別，初始化 DebuggerTypeProxyAttribute 類別的新執行個體。

屬性

ProxyTypeName	取得 Proxy 型別的型別名稱。
Target	取得或設定屬性的目標型別。
TargetTypeName	取得或設定目標型別的名稱。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• 使用 DebuggerTypeProxy 屬性