Elemento trace (schema delle impostazioni ASP.NET)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
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 descritti gli attributi, gli elementi figlio e gli elementi padre.
Attributi
Attributo |
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.
ValoreDescrizione
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 |
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
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.
È 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 |
|
Membro di configurazione |
|
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
Attività
How to: View Trace Information with the Trace Viewer
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Riferimenti
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento configuration (schema delle impostazioni generali)
Concetti
ASP.NET Configuration File Hierarchy
Altre risorse
Impostazioni di configurazione generali (ASP.NET)
Impostazioni di configurazione di ASP.NET