Elemento trace (schema delle impostazioni ASP.NET)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Configura il servizio di analisi del codice ASP.NET che controlla le modalità di raccolta, memorizzazione e visualizzazione dei risultati dell'analisi.

Elemento configuration (schema delle impostazioni generali)
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento trace (schema delle impostazioni ASP.NET)

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

enabled

Attributo Boolean facoltativo.

Specifica se è attivata la funzione di analisi per un'applicazione. Per utilizzare il visualizzatore Trace.axd la funzione di analisi deve essere attivata. Per impostazione predefinita, il visualizzatore Trace.axd viene aggiunto all'elemento httpHandlers.

L'impostazione predefinita è false.

localOnly

Attributo Boolean facoltativo.

Specifica se il visualizzatore di analisi (Trace.axd) è disponibile solo sul server Web host. Se il valore dell'attributo è false, il visualizzatore di analisi è disponibile su qualsiasi computer. Per impostazione predefinita, il visualizzatore Trace.axd viene aggiunto all'elemento httpHandlers.

Il valore predefinito è true.

mostRecent

Attributo Boolean facoltativo.

Specifica se viene visualizzato l'output di analisi più recente a livello di applicazione e se vengono eliminati i dati di analisi precedenti che superano i limiti indicati da requestLimit. Se il valore dell'attributo è false, i dati di analisi relativi alle richieste vengono visualizzati fino a quando si raggiunge l'attributo requestLimit.

Questo attributo è nuovo in .NET Framework versione 2.0.

L'impostazione predefinita è false.

pageOutput

Attributo Boolean facoltativo.

Specifica se al termine di ogni pagina dev'essere aggiunto l'output di analisi. Se il valore dell'attributo è false, l'output di analisi è accessibile solo mediante l'utilità di analisi.

L'impostazione predefinita è false.

requestLimit

Attributo Int32 facoltativo.

Specifica il numero di richieste di analisi da archiviare sul server. Se si raggiunge il valore limite e l'attributo mostRecent è false, la funzione di analisi viene disattivata automaticamente.

Il limite massimo di richieste è 10.000. Se viene specificato un valore superiore a 10.000, viene automaticamente arrotondato per difetto a 10.000 da ASP.NET.

L'impostazione predefinita è 10.

traceMode

Attributo TraceDisplayMode facoltativo.

Specifica l'ordine di visualizzazione delle informazioni di analisi.

L'attributo traceMode può essere uno dei valori riportati di seguito.

Valore	Descrizione
SortByCategory	Specifica che le informazioni di analisi vengono visualizzate in ordine alfabetico in base alla categoria definita dall'utente.
SortByTime	Specifica che le informazioni di analisi vengono visualizzate nell'ordine in cui vengono elaborate.

Il valore predefinito è SortByTime.

writeToDiagnosticsTrace

Attributo Boolean facoltativo.

Specifica se i messaggi di analisi di ASP.NET vengono inoltrati all'infrastruttura di analisi System.Diagnostics, per qualsiasi listener registrato per la visualizzazione dei messaggi di Trace. Per ulteriori informazioni, vedere l'elemento trace di system.diagnostics.

Questo attributo è nuovo in .NET Framework versione 2.0.

Il valore predefinito è false.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	È l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.web	Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento.

Note

L'elemento trace configura il servizio di analisi del codice ASP.NET che controlla le modalità di raccolta, memorizzazione e visualizzazione dei risultati dell'analisi.

Quando la funzione di analisi è attivata, ogni richiesta di pagina genera messaggi di analisi che possono essere accodati all'output della pagina o memorizzati in un log di analisi dell'applicazione. Per visualizzare il contenuto di tale log è possibile utilizzare il visualizzatore di analisi di ASP.NET (Trace.axd). Per impostazione predefinita, Trace.axd viene aggiunto all'elemento httpHandlers.

Nota

Di solito è preferibile non attivare la funzione di analisi in un sito Web attivo in quanto è possibile che informazioni di configurazione riservate vengano visualizzate a chiunque apra le pagine nel sito specifico. L'analisi è destinata esclusivamente ad attività di debug. Se l'attributo localOnly è true, le informazioni di analisi vengono visualizzate solo per le richieste dell'host locale. Inoltre, se <deployment retail=true> è impostato nel file Web.config, la funzione di analisi è disattivata.

È possibile utilizzare le proprietà e i metodi della classe Trace per instrumentare le build di rilascio. La strumentazione consente di monitorare lo stato dell'applicazione eseguendola con impostazioni reali. L'analisi consente di isolare e correggere i problemi senza danneggiare un sistema in esecuzione.

Affinché l'analisi diventi effettiva, è necessario ricompilare l'applicazione con il flag di analisi impostato. A tale scopo, impostare l'attributo compilerOptions su = "/d:TRACE" nella riga di configurazione del compilatore di linguaggio che si desidera supporti l'analisi. Vedere Elemento <compiler>.

Configurazione predefinita

L'elemento trace predefinito riportato di seguito non viene configurato in modo esplicito nel file Machine.config o nel file Web.config principale. Si tratta, tuttavia, della configurazione predefinita restituita dall'applicazione in .NET Framework 2.0.

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

Nel file Machine.config in .NET Framework versioni 1.0 e 1.1 viene configurato l'elemento element predefinito riportato di seguito.

<trace
   enabled="false"
   localOnly="true"
   pageOutput="false"
   requestLimit="10"
   traceMode="SortByTime"
/>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come specificare le impostazioni di configurazione di analisi.

<configuration>
  <system.web>
    <trace enabled="true" 
      pageOutput="true"
      requestLimit="15"
      mostRecent="true" />
    <system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	TraceSection
Membro di configurazione	TraceSection
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 1.0, 1.1 o 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite

Elemento trace (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive