Indicare al debugger cosa mostrare usando l'attributo DebuggerDisplay (C#, Visual Basic, F#, C++/CLI)
DebuggerDisplayAttribute controlla la modalità di visualizzazione di un oggetto, una proprietà o un campo nelle finestre delle variabili del debugger. Questo attributo può essere applicato ai tipi (classi, struct, enumerazioni, delegati), ma in genere viene applicato solo a classi e struct. Se applicato a un tipo di base, l'attributo si applica anche a una sottoclasse.
L'attributo DebuggerDisplay presenta un solo argomento, costituito da una stringa da visualizzare nella colonna del valore per le istanze del tipo. Questa stringa può contenere parentesi graffe ({ e }). Il testo racchiuso tra due parentesi graffe viene valutato come un campo, una proprietà o un metodo.
Se una classe dispone di un metodo ToString() sottoposto a override, il debugger usa il metodo sottoposto a override anziché il valore {<typeName>}predefinito. Pertanto, se è stato eseguito l'override del ToString() metodo , il debugger usa il metodo sottoposto a override anziché il valore predefinito {<typeName>}e non è necessario usare DebuggerDisplay. Se si usano entrambi, l'attributo DebuggerDisplay avrà la precedenza sul metodo ToString() sottoposto a override. L'attributo DebuggerDisplay ha anche la precedenza sul metodo sottoposto ToString() a override in una sottoclasse.
Se il debugger valuta questa chiamata implicita ToString() dipende da un'impostazione utente nella finestra di dialogo Strumenti/Opzioni/Debug .
Importante
Se la casella di controllo Mostra struttura non elaborata di oggetti nelle finestre variabili è selezionata nella finestra di dialogo Strumenti/Opzioni/Debug , l'attributo DebuggerDisplay viene ignorato.
Nota
Per il codice nativo, questo attributo è supportato solo nel codice C++/CLI.
Nella tabella riportata di seguito vengono visualizzati alcuni utilizzi possibili dell'attributo DebuggerDisplay e alcuni output di esempio.
| Attributo | Output visualizzato nella colonna Valore |
|---|---|
[DebuggerDisplay("x = {x} y = {y}")]Utilizzato in un tipo con campi x e y. |
x = 5 y = 18 |
[DebuggerDisplay("String value is {getString()}")]La sintassi del parametro può variare a seconda del linguaggio. Prestare, pertanto, particolare attenzione. |
String value is [5, 6, 6] |
DebuggerDisplay può anche accettare parametri denominati.
| Parametri | Scopo |
|---|---|
Name, Type |
Questi parametri influiscono sulle colonne Nome e Tipo delle finestre delle variabili. Possono essere impostati su stringhe usando la stessa sintassi del costruttore. L'utilizzo eccessivo di questi parametri, o l'uso non corretto, può causare un output confuso. |
Target, TargetTypeName |
Specifica il tipo di destinazione quando l'attributo viene utilizzato a livello di assembly. |
Il file autoexp.cs usa l'attributo DebuggerDisplay a livello di assembly. Il file autoexp.cs determina le espansioni predefinite usate da Visual Studio per gli oggetti .NET. Esaminare il file autoexp.cs per esempi di utilizzo dell'attributo DebuggerDisplay oppure modificare e compilare il file autoexp.cs per modificare le espansioni predefinite. Assicurarsi di eseguire il backup del file autoexp.cs prima di modificarlo.
Per compilare autoexp.cs, aprire un prompt dei comandi per gli sviluppatori per VS2015 ed eseguire i comandi seguenti.
cd <directory containing autoexp.cs>
csc /t:library autoexp.cs
Le modifiche apportate ad autoexp.dll verranno rilevate nella sessione di debug successiva.
Utilizzo di espressioni in DebuggerDisplay
Sebbene sia possibile utilizzare un'espressione generale tra parentesi graffe in un attributo DebuggerDisplay, questa procedura non è consigliata.
Un'espressione generale in DebuggerDisplay ha accesso implicito al puntatore this solo per l'istanza corrente del tipo di destinazione. L'espressione non ha accesso ad alias, variabili locali o puntatori. Se l'espressione fa riferimento a delle proprietà, gli attributi su tali proprietà non vengono elaborati. Ad esempio, il codice C# [DebuggerDisplay("Object {count - 2}")] visualizza Object 6 se il campo count è 8.
L'utilizzo di espressioni in DebuggerDisplay può causare i problemi seguenti:
La valutazione delle espressioni è l'operazione più dispendiosa nel debugger e viene valutata ogni volta che viene visualizzata. Ciò può causare problemi relativi alle prestazioni nell'esecuzione del codice istruzione per istruzione. Ad esempio, un'espressione complessa che viene utilizzata per visualizzare i valori in una raccolta o in un elenco può essere molto lenta quando è presente un grande numero di elementi.
Le espressioni vengono valutate dall'analizzatore di espressioni del linguaggio dello stack frame corrente, non dall'analizzatore del linguaggio in cui l'espressione è stata scritta. Questa situazione può provocare risultati imprevisti quando i linguaggi sono diversi.
La valutazione di un'espressione può modificare lo stato dell'applicazione. Ad esempio, un'espressione che imposta il valore di una proprietà modifica il valore della proprietà nel codice in esecuzione.
Per ridurre i possibili problemi della valutazione dell'espressione, è possibile creare una proprietà privata che esegue l'operazione e restituisce una stringa. L'attributo DebuggerDisplay può quindi visualizzare il valore di tale proprietà privata. Nell'esempio seguente viene implementato questo modello:
[DebuggerDisplay("{DebuggerDisplay,nq}")]
public sealed class MyClass
{
public int count { get; set; }
public bool flag { get; set; }
private string DebuggerDisplay
{
get
{
return string.Format("Object {0}", count - 2);
}
}
}
Il suffisso "nq" indica all'analizzatore di espressioni di rimuovere le virgolette quando viene visualizzato il valore finale (nq = senza virgolette).
Esempio
Nell'esempio di codice seguente viene illustrato l'utilizzo di DebuggerDisplay, insieme a DebuggerBrowsable e DebuggerTypeProxy. Quando è visualizzato in una finestra delle variabili del debugger, come la finestra Espressioni di controllo , produce un'espansione analoga alla seguente:
| Nome | valore | Type |
|---|---|---|
| Chiave | "three" | oggetto {string} |
| Valore | 3 | oggetto {int} |
[DebuggerDisplay("{value}", Name = "{key}")]
internal class KeyValuePairs
{
private IDictionary dictionary;
private object key;
private object value;
public KeyValuePairs(IDictionary dictionary, object key, object value)
{
this.value = value;
this.key = key;
this.dictionary = dictionary;
}
public object Key
{
get { return key; }
set
{
object tempValue = dictionary[key];
dictionary.Remove(key);
key = value;
dictionary.Add(key, tempValue);
}
}
public object Value
{
get { return this.value; }
set
{
this.value = value;
dictionary[key] = this.value;
}
}
}
[DebuggerDisplay("{DebuggerDisplay,nq}")]
[DebuggerTypeProxy(typeof(HashtableDebugView))]
class MyHashtable
{
public Hashtable hashtable;
public MyHashtable()
{
hashtable = new Hashtable();
}
private string DebuggerDisplay { get { return "Count = " + hashtable.Count; } }
private class HashtableDebugView
{
private MyHashtable myhashtable;
public HashtableDebugView(MyHashtable myhashtable)
{
this.myhashtable = myhashtable;
}
[DebuggerBrowsable(DebuggerBrowsableState.RootHidden)]
public KeyValuePairs[] Keys
{
get
{
KeyValuePairs[] keys = new KeyValuePairs[myhashtable.hashtable.Count];
int i = 0;
foreach (object key in myhashtable.hashtable.Keys)
{
keys[i] = new KeyValuePairs(myhashtable.hashtable, key, myhashtable.hashtable[key]);
i++;
}
return keys;
}
}
}
}