Cenni preliminari sull'analisi di ASP.NET

Aggiornamento: novembre 2007

L'analisi di ASP.NET consente di visualizzare informazioni diagnostiche su una singola richiesta relativa a una pagina ASP.NET, La funzione di analisi ASP.NET consente di seguire il percorso di esecuzione di una pagina, visualizzare informazioni diagnostiche in fase di esecuzione ed eseguire il debug dell'applicazione. La funzione può essere integrata con l'analisi a livello di sistema per offrire più livelli di output di analisi nelle applicazioni distribuite e a più livelli.

Vengono illustrati i seguenti argomenti:

• Funzionalità

• Informazioni di supporto

• Esempi di codice

• Riferimento alle classi

Funzionalità

Di seguito sono riportate le funzionalità dell'analisi ASP.NET:

• Debugging statments    È possibile scrivere istruzioni di debug direttamente nel codice, senza doverle rimuovere dall'applicazione quando questa viene distribuita nei server di produzione. È anche possibile scrivere variabili o strutture in una pagina e analizzare il percorso di esecuzione della pagina o dell'applicazione.

• Integrated tracing functionality   È possibile indirizzare i messaggi generati dalla classe System.Diagnostics.Trace all'output di analisi ASP.NET e i messaggi generati dall'analisi ASP.NET a System.Diagnostics.Trace. È anche possibile inoltrare gli eventi della strumentazione ASP.NET a System.Diagnostics.Trace. Per ulteriori informazioni, vedere Procedura dettagliata: integrazione dell'analisi ASP.NET all'analisi System.Diagnostics.

• Programmatic access to trace messages   È possibile accedere ai messaggi di analisi e modificarli dal codice per un controllo più accurato del formato di tali messaggi o per un'elaborazione aggiuntiva necessaria.

• Application-level tracing   L'opzione di analisi a livello di applicazione consente di visualizzare i dati di analisi più recenti disponibili senza riavviare una sessione di analisi né aumentare il volume dei dati di analisi da archiviare nel server. I dati di analisi più recenti vengono visualizzati, mentre quelli meno recenti vengono eliminati.

Torna all'inizio

Informazioni di supporto

L'analisi consente di aggiungere informazioni diagnostiche e messaggi personalizzati all'output della pagina e inviare tali informazioni al browser richiedente. Facoltativamente è possibile visualizzare queste informazioni in un apposito visualizzatore distinto, Trace.axd, in cui vengono visualizzate le informazioni di analisi per ogni pagina di un'applicazione Web ASP.NET. Tali informazioni consentono di analizzare errori o risultati indesiderati mentre in ASP.NET viene elaborata una richiesta di pagina.

È possibile configurare pagine singole per la visualizzazione di informazioni di analisi. In alternativa, è possibile configurare il file Web.config dell'applicazione in modo che le informazioni di analisi vengano visualizzate in tutte le pagine, a meno che la funzione di analisi non venga esplicitamente disattivata in una pagina. L'impostazione dell'analisi a livello di applicazione è utile in quanto la relativa attivazione e disattivazione non richiede alcuna modifica alle singole pagine.

Le istruzioni di analisi vengono elaborate e visualizzate solo quando è attivata la funzione di analisi. È possibile decidere se visualizzare l'analisi in una pagina, in un visualizzatore di analisi o in entrambi. Per informazioni sull'attivazione dell'analisi per una pagina, vedere Procedura: attivare l'analisi per una pagina ASP.NET. Per informazioni sull'attivazione dell'analisi per un'applicazione, vedere Procedura: attivare l'analisi per un'applicazione ASP.NET.

Analisi di ASP.NET a livello di applicazione

Per attivare l'analisi a livello di applicazione, utilizzare l'elemento trace del file Web.config. Quando si attiva la funzione di analisi a livello di applicazione, vengono raccolte informazioni di analisi per ogni richiesta all'applicazione, fino a raggiungere il numero massimo di richieste specificato. Il numero predefinito di richieste è 10. Per impostazione predefinita, quando il visualizzatore di analisi raggiunge il limite di richieste, l'archiviazione di queste ultime viene interrotta. È possibile configurare l'analisi in modo tale da archiviare i dati meno recenti ed eliminare quelli più recenti o viceversa.

Nota:

Quando si attiva l'analisi per l'intera applicazione nel file Web.config, vengono raccolte ed elaborate le informazioni di analisi per ogni pagina dell'applicazione. Per eseguire l'override delle impostazioni a livello di applicazione, impostare l'attributo Trace nella direttiva @ Page della pagina su false. Qualsiasi istruzione Write o Warn inserita nel codice di una pagina verrà archiviata e restituita esclusivamente al visualizzatore di analisi.

Visualizzazione delle informazioni di analisi

È possibile visualizzare le informazioni di analisi nella parte inferiore delle singole pagine. In alternativa, è possibile utilizzare il visualizzatore delle informazioni di analisi (Trace.axd) per visualizzare le informazioni raccolte e memorizzate nella cache da ASP.NET quando l'analisi viene attivata. Per informazioni dettagliate sulla visualizzazione dell'analisi, vedere Lettura delle informazioni di analisi di ASP.NET più avanti in questo argomento.

Se si desidera visualizzare le informazioni di analisi alla fine della pagina a cui sono associate, impostare l'attributo PageOutput dell'elemento trace su true. Se si attiva l'analisi a livello di applicazione, ma si desidera che per alcune pagine non vengano visualizzate le informazioni di analisi, è possibile impostare l'attributo Trace nella direttiva @ Page di tali pagine su false. Per ulteriori informazioni sulla configurazione di un'applicazione ASP.NET, vedere Cenni preliminari sulla configurazione di ASP.NET.

Per impostazione predefinita, l'analisi a livello di applicazione può essere visualizzata solo sul computer server Web locale. Per rendere visibili le informazioni di analisi a livello di applicazione per i computer remoti, è possibile impostare l'attributo LocalOnly dell'elemento trace su false.

Nota:
Per ragioni di protezione, utilizzare la funzionalità di analisi remota solo durante lo sviluppo o la distribuzione di un'applicazione Web. Accertarsi che venga disattivata prima di trasferire l'applicazione ai server Web di produzione. A tal proposito, impostare l'attributo LocalOnly su true nel file Web.config.

Nell'esempio seguente viene illustrata una configurazione di analisi di un'applicazione che raccoglie informazioni per un massimo di 40 richieste. Viene inoltre consentito ai browser di computer diversi dal server di visualizzare le informazioni raccolte tramite l'apposito visualizzatore.

<configuration>
  <system.web>
    <trace enabled="true" requestLimit="40" localOnly="false" />
  </system.web>
</configuration>

Scrittura di messaggi di analisi ASP.NET personalizzati

È possibile aggiungere informazioni di analisi personalizzate alla visualizzazione dell'analisi in una pagina ASP.NET o al log di analisi. Le informazioni scritte nel log di analisi possono essere visualizzate mediante l'apposito visualizzatore. Per ulteriori informazioni, vedere Procedura: visualizzare le informazioni di analisi di ASP.NET con il visualizzatore di analisi.

È possibile scrivere informazioni di analisi utilizzando il metodo Warn o Write della classe TraceContext. La differenza tra i due metodi è che un messaggio scritto con il metodo Warn viene visualizzato in rosso.

Nell'esempio riportato di seguito viene illustrato come utilizzare la classe TraceContext per visualizzare le informazioni di analisi alla fine di una pagina ASP.NET. Per ogni controllo LinkButton che ha causato il postback viene generata un'eccezione differente. Il messaggio di errore utilizzato per inizializzare l'istanza ArgumentException o InvalidOperationException viene visualizzato nel log di analisi.

<%@ Page Language="VB" Trace="true" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<script >

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    Try
      If (IsPostBack) Then

        Select Case Request.Form("__EVENTTARGET")
          Case "WarnLink"
            Throw New ArgumentException("Trace warn.")
          Case "WriteLink"
            Throw New InvalidOperationException("Trace write.")
          Case Else
            Throw New ArgumentException("General exception.")
        End Select  
      End If
    Catch ae As ArgumentException
      Trace.Warn("Exception Handling", "Warning: Page_Load.", ae)
    Catch ioe As InvalidOperationException
      Trace.Write("Exception Handling", "Exception: Page_Load.", ioe)
    End Try
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head >
    <title>Trace Example</title>
</head>
<body>
    <form id="form1" >
    <div>
      <asp:LinkButton id="WriteLink" 
                      
                      text="Generate Trace Write" />
      <asp:LinkButton id="WarnLink"
                      
                      text="Generate Trace Warn" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="C#" Trace="true"  %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<script >
void Page_Load(object sender, EventArgs e)
{
    try {
      if (IsPostBack)
      {

        switch (Request.Form["__EVENTTARGET"])
        {
          case "WarnLink":
            throw new ArgumentException("Trace warn.");
            break;
          case "WriteLink":
            throw new InvalidOperationException("Trace write.");
            break;
          default:
            throw new ArgumentException("General exception.");
            break;          
        }
      }
    }
    catch (ArgumentException ae) {    
        Trace.Warn("Exception Handling", "Warning: Page_Load.", ae);
    }
    catch (InvalidOperationException ioe) {    
        Trace.Write("Exception Handling", "Exception: Page_Load.", ioe);
    }
}

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head >
    <title>Trace Example</title>
</head>
<body>
    <form id="form1" >
    <div>
      <asp:LinkButton id="WriteLink" 
                      
                      text="Generate Trace Write" />
      <asp:LinkButton id="WarnLink"
                      
                      text="Generate Trace Warn" />
    </div>
    </form>
</body>
</html>

Lettura delle informazioni di analisi di ASP.NET

È possibile visualizzare le informazioni di analisi aggiunte alla fine di una pagina ASP.NET o nell'apposito visualizzatore. In entrambi i casi le informazioni visualizzate saranno identiche. ASP.NET organizza le informazioni di analisi in una serie di tabelle. Per informazioni sulla visualizzazione delle informazioni di analisi in una pagina, vedere Procedura: attivare l'analisi per una pagina ASP.NET. Per informazioni sulla visualizzazione delle informazioni di analisi nell'apposito visualizzatore, vedere Procedura: visualizzare le informazioni di analisi di ASP.NET con il visualizzatore di analisi.

Le informazioni di analisi vengono visualizzate nell'ordine indicato di seguito.

Dettagli richiesta

Nella sezione Dettagli richiesta vengono visualizzate informazioni generali sulla richiesta e sulla risposta corrente.

Informazioni analisi

Nella sezione Informazioni analisi viene visualizzato il flusso degli eventi a livello di pagina. Se sono stati creati messaggi di analisi personalizzati, anche questi ultimi vengono visualizzati nella sezione Informazioni analisi.

Struttura controllo

Nella sezione Struttura controllo vengono visualizzate le informazioni sui controlli server ASP.NET creati nella pagina.

Stato sessione

Nella sezione Stato sessione vengono visualizzate le informazioni sugli eventuali valori archiviati nello stato sessione. Per ulteriori informazioni, vedere la classe Cenni preliminare sullo stato della sessione ASP.NET.

Stato applicazione

Nella sezione Stato applicazione vengono visualizzate informazioni sugli eventuali valori archiviati nello stato applicazione. Per ulteriori informazioni, vedere la classe Cenni preliminari sullo stato delle applicazioni ASP.NET.

Insieme Cookies

Nelle sezioni Cookie di richiesta e Cookie di risposta vengono visualizzate le informazioni sui cookie passati tra il browser e il server a ogni richiesta e risposta. In questa sezione vengono visualizzati sia i cookie permanenti che quelli di sessione. In ASP.NET alcuni cookie vengono creati automaticamente, ad esempio quelli per lo stato sessione basato su cookie e per l'autenticazione basata su form. Per ulteriori informazioni, vedere Cenni preliminari sui cookie ASP.NET.

Insieme Headers

Nella sezione Insieme Headers vengono visualizzate informazioni sulle coppie nome/valore dell'intestazione dei messaggi di richiesta e di risposta, che specificano il corpo del messaggio o la risorsa richiesta. Le informazioni sull'intestazione vengono utilizzate per controllare la modalità di elaborazione dei messaggi di richiesta e di creazione dei messaggi di risposta. Per ulteriori informazioni sulle intestazioni HTTP, vedere la specifica RFC 2616 sul sito Web di World Wide Web Consortium (W3C) (informazioni in lingua inglese).

Insieme Form

Nella sezione Insieme Form vengono visualizzate le coppie nome/valore che indicano i valori degli elementi form (valori di controllo) inviati in una richiesta durante un'operazione POST (postback).

Insieme Querystring

Nella sezione Insieme Querystring vengono visualizzati i valori passati nell'URL. In un URL le informazioni sulle stringhe di query sono separate dalle informazioni sul percorso mediante un punto interrogativo (?). In caso di stringhe di query con più elementi, questi vengono separati mediante una e commerciale (&). Le coppie nome/valore delle stringhe di query sono separate da un segno di uguale (=). La proprietà QueryString dell'oggetto HttpRequest restituisce una classe NameValueCollection di variabili di stringhe di query.

Variabili server

Nella sezione Variabili server viene visualizzato un insieme di variabili di ambiente relative al server, oltre a informazioni sull'intestazione di richiesta. La proprietà ServerVariables dell'oggetto HttpRequest restituisce una classe NameValueCollection di variabili server.

Torna all'inizio

Analisi di ASP.NET e analisi diagnostica

Durante l'analisi di ASP.NET vengono scritti messaggi visualizzati nelle pagine Web ASP.NET e nel visualizzatore di analisi ASP.NET (Trace.axd). La classe System.Diagnostics.Trace viene invece utilizzata per scrivere messaggi nell'output di analisi .NET Framework standard, generalmente una finestra della console. Per tenere traccia con maggiore facilità dell'interazione delle pagine Web ASP.NET con gli oggetti business e altri componenti, è possibile integrare l'output di analisi ASP.NET con l'analisi System.Diagnostics. Sarà quindi possibile indirizzare tutti i messaggi di analisi a uno di questi output.

Un comune scenario di utilizzo dell'analisi di ASP.NET e di System.Diagnostics.Trace è dato dalle pagine Web che utilizzano oggetti business di livello intermedio per interagire con dati e regole business. È anche possibile utilizzare l'analisi System.Diagnostics.Trace per le pagine che utilizzano servizi Enterprise, ad esempio transazioni e code. In queste situazioni, i componenti business ed Enterprise giocano un ruolo fondamentale per una corretta esecuzione della pagina. Possono inoltre rivelarsi utili per l'analisi dell'applicazione, per controllare il flusso di esecuzione attraverso i diversi livelli utilizzando un solo output di analisi. Per ulteriori informazioni, vedere Procedura: attivare l'analisi per un'applicazione ASP.NET.

Attributi della configurazione di analisi

Nella tabella riportata di seguito vengono illustrati gli attributi utilizzabili per modificare il comportamento dell'analisi a livello di applicazione nell'elemento trace del file Web.config.

Attributo	Descrizione
Enabled	true per attivare l'analisi per l'applicazione; in caso contrario false. Il valore predefinito è false. È possibile eseguire l'override di questa impostazione per singole pagine impostando l'attributo Trace nella direttiva @ Page di una pagina su true o false.
PageOutput	true per visualizzare l'analisi sia nelle pagine sia nel visualizzatore di analisi (Trace.axd); in caso contrario false. Il valore predefinito è false. Nota: Questa impostazione non ha effetto sulle pagine singole per cui è attiva la funzione di analisi.
RequestLimit	Numero di richieste di analisi da memorizzare nel server. Il valore predefinito è 10.
TraceMode	Ordine in cui vengono visualizzate le informazioni di analisi. Impostare su SortByTime per eseguire l'ordinamento in base all'ordine di elaborazione delle informazioni. Impostare su SortByCategory per ordinare alfabeticamente in base a una categoria definita dall'utente. Il valore predefinito è SortByTime.
LocalOnly	true per rendere disponibile il visualizzatore di analisi (Trace.axd) solo sul server Web host; in caso contrario false. Il valore predefinito è true.
MostRecent	true per visualizzare le informazioni di analisi più recenti come output di analisi; in caso contrario, false. Se il valore è false, in caso di superamento del valore requestLimit le nuove richieste non verranno archiviate. L'impostazione predefinita è false. Nota: I dati di analisi che superano il limite definito dall'attributo requestLimit vengono eliminati a favore dei dati più recenti solo quando mostRecent è true.

Esempi di codice

Argomenti relativi alle procedure e alle procedure dettagliate

Procedura: attivare l'analisi per una pagina ASP.NET

Procedura: attivare l'analisi per un'applicazione ASP.NET

Procedura: visualizzare le informazioni di analisi di ASP.NET con il visualizzatore di analisi

Procedura dettagliata: integrazione dell'analisi ASP.NET all'analisi System.Diagnostics

Torna all'inizio

Riferimento alle classi

Torna all'inizio

Vedere anche

Concetti

Prestazioni, risoluzione dei problemi e debug

Riferimenti

Torna all'inizio