Elemento trace (schema delle impostazioni ASP.NET)

Articolo
08/11/2011

Configura il servizio di tracciatura del codice ASP.NET che controlla le modalità di raccolta, memorizzazione e visualizzazione dei risultati della traccia.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	Oggetto di descrizione
enabled	Attributo Boolean facoltativo. Specifica se è attivata la funzione di tracciatura per un'applicazione. Per utilizzare il visualizzatore Trace.axd la funzione di tracciatura deve essere attivata. Per impostazione predefinita, il visualizzatore Trace.axd viene aggiunto all'elemento httpHandlers. Il valore predefinito è false.
localOnly	Attributo Boolean facoltativo. Specifica se il visualizzatore di traccia (Trace.axd) è disponibile solo sul server Web host. Se il valore dell'attributo è false, il visualizzatore di traccia è 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 traccia più recente a livello di applicazione e se vengono eliminati i dati di traccia precedenti che superano i limiti indicati da requestLimit. Se il valore dell'attributo è false, i dati di traccia relativi alle richieste vengono visualizzati fino a quando si raggiunge l'attributo requestLimit. Questo attributo è nuovo in .NET Framework versione 2.0. Il valore predefinito è false.
pageOutput	Attributo Boolean facoltativo. Specifica se al termine di ogni pagina dev'essere aggiunto l'output di traccia. Se il valore dell'attributo è false, l'output di traccia è accessibile solo mediante l'utilità di traccia. Il valore predefinito è false.
requestLimit	Attributo Int32 facoltativo. Specifica il numero di richieste di traccia da archiviare sul server. Se si raggiunge il valore limite e l'attributo mostRecent è false, la funzione di tracciatura viene disabilitata 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. Il valore predefinito è 10.
traceMode	Attributo TraceDisplayMode facoltativo. Specifica l'ordine di visualizzazione delle informazioni di traccia. L'attributo traceMode può essere uno dei valori riportati di seguito. ValueOggetto di descrizione SortByCategory Specifica che le informazioni di traccia vengono visualizzate in ordine alfabetico in base alla categoria definita dall'utente. SortByTime Specifica che le informazioni di traccia vengono visualizzate nell'ordine in cui vengono elaborate. Il valore predefinito è SortByTime.
writeToDiagnosticsTrace	Attributo Boolean facoltativo. Specifica se i messaggi di traccia di ASP.NET vengono inoltrati all'infrastruttura di tracciatura 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	Oggetto di 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 per la configurazione di applicazioni Web ASP.NET e il controllo del comportamento delle stesse.

Note

Quando la tracciatura è attivata, ciascuna richiesta di pagina genera messaggi di traccia che possono essere aggiunti all'output della pagina o archiviati in un log di traccia dell'applicazione. È possibile visualizzare il contenuto del log di traccia tramite il relativo visualizzatore di ASP.NET (Trace.axd). Per impostazione predefinita, Trace.axd viene aggiunto all'elemento httpHandlers.

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

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

È 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. La tracciatura consente di isolare e correggere i problemi senza danneggiare un sistema in esecuzione.

Affinché la traccia diventi effettiva, è necessario ricompilare l'applicazione con il flag di traccia impostato. A tale scopo, impostare l'attributo compilerOptions su = "/d:TRACE" nella riga di configurazione del compilatore di linguaggio che si desidera supporti la tracciatura. 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 radice. Si tratta, tuttavia, della configurazione predefinita restituita dall'applicazione in .NET Framework 2.0 e versioni successive.

<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 trace 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 tracciatura.

<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) 5.0 o versioni successive .NET Framework Microsoft Visual Studio

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à

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive