TraceContext.Write Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scrive le informazioni di traccia nel log della traccia.

Overload

Write(String)	Scrive un messaggio di traccia nel log dell'analisi.
Write(String, String)	Scrive le informazioni di traccia nel log della traccia, includendo un messaggio ed eventuali categorie definite dall'utente.
Write(String, String, Exception)	Scrive le informazioni di traccia nel log della traccia, incluse eventuali categorie definite dall'utente, messaggi di analisi e informazioni sugli errori.

Write(String)

Scrive un messaggio di traccia nel log dell'analisi.

public:
 void Write(System::String ^ message);

public void Write (string message);

member this.Write : string -> unit

Public Sub Write (message As String)

Parametri

message: String

Il messaggio di traccia da scrivere nel log.

Commenti

Ogni volta che viene chiamato il Write metodo, viene aggiunto un TraceContext messaggio di traccia alla TraceRecords raccolta messaggi, accessibile quando si gestisce l'evento TraceFinished . Il messaggio viene aggiunto con la relativa IsWarning proprietà impostata su false e la relativa ErrorInfo proprietà impostata su null.

Vedi anche

Cenni preliminari sulla funzionalità di traccia di ASP.NET

Si applica a

Write(String, String)

Scrive le informazioni di traccia nel log della traccia, includendo un messaggio ed eventuali categorie definite dall'utente.

public:
 void Write(System::String ^ category, System::String ^ message);

public void Write (string category, string message);

member this.Write : string * string -> unit

Public Sub Write (category As String, message As String)

Parametri

category: String

La categoria di traccia che riceve il messaggio.

message: String

Il messaggio di traccia da scrivere nel log.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il Write metodo per scrivere un messaggio di traccia degli errori nel log di traccia. In questo esempio il delegato esegue l'iterazione dei messaggi di traccia e li scrive come tabella HTML; Tuttavia, è possibile scrivere le stesse informazioni in un database o in un consumer di strumenti di profilatura.

<%@ Page language="c#" Trace="true" %>
<script runat="server">
void Page_Load(object sender, EventArgs e)
{
    // Register a handler for the TraceFinished event.
    Trace.TraceFinished += new 
        TraceContextEventHandler(this.OnTraceFinished);

    // Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.");
}
 
// A TraceContextEventHandler for the TraceFinished event.
void OnTraceFinished(object sender, TraceContextEventArgs e)
{
    TraceContextRecord r = null;    
    
    // Iterate through the collection of trace records and write 
    // them to the response stream.
    Response.Write("<table>");
    foreach(object o in e.TraceRecords)
    {
        r = (TraceContextRecord)o;
        Response.Write(String.Format("<tr><td>{0}</td><td>{1}</td></tr>", r.Message, r.Category));        
    }
    Response.Write("</table>");
}       
</script>

<%@ Page language="VB" Trace="true" %>
<script runat="server">
' The Page_Load method.
Private Sub Page_Load(sender As Object, e As EventArgs)

    ' Register a handler for the TraceFinished event.
    AddHandler Trace.TraceFinished, AddressOf OnTraceFinished

    ' Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.")
End Sub ' Page_Load
 
' A TraceContextEventHandler for the TraceFinished event.
Private Sub OnTraceFinished(sender As Object, e As TraceContextEventArgs)

    Dim r As TraceContextRecord
    Dim o As Object
    
    ' Iterate through the collection of trace records and write 
    ' them to the response stream.
    Response.Write("<table>")
    For Each o In e.TraceRecords
        r = CType(o, TraceContextRecord)
        Response.Write(String.Format("<tr><td>{0}</td><td>{1}</td></tr>", r.Message, r.Category))
    Next
    Response.Write("</table>")

End Sub ' OnTraceFinished
</script>

Commenti

Vedi anche

Cenni preliminari sulla funzionalità di traccia di ASP.NET

Si applica a

Write(String, String, Exception)

Scrive le informazioni di traccia nel log della traccia, incluse eventuali categorie definite dall'utente, messaggi di analisi e informazioni sugli errori.

public:
 void Write(System::String ^ category, System::String ^ message, Exception ^ errorInfo);

public void Write (string category, string message, Exception errorInfo);

member this.Write : string * string * Exception -> unit

Public Sub Write (category As String, message As String, errorInfo As Exception)

Parametri

category: String

La categoria di traccia che riceve il messaggio.

message: String

Il messaggio di traccia da scrivere nel log.

errorInfo: Exception

Un'eccezione Exception che contiene informazioni sull'errore.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il Write metodo per scrivere un messaggio di traccia degli errori nel log di traccia. In questo esempio vengono tracciate diverse eccezioni come errori e avvisi. Quando la pagina genera un ArgumentExceptionoggetto , scrive un messaggio di avviso usando il Warn metodo . Quando la pagina genera un oggetto , scrive un InvalidOperationExceptionmessaggio di errore usando il Write metodo .

<%@ Page language="c#" Trace="true" %>
<script runat="server">
void Page_Load(object sender, EventArgs e)
{
    // Register a handler for the TraceFinished event.
    Trace.TraceFinished += new 
        TraceContextEventHandler(this.OnTraceFinished);

    try {
        throw new ArgumentException("Trace Test");
    }
    catch (InvalidOperationException ioe) {    
        // You can write an error trace message using the Write method.
        Trace.Write("Exception Handling", "Exception: Page_Load.", ioe);
    }
    catch (ArgumentException ae) {    
        // You can write a warning trace message using the Warn method.
        Trace.Warn("Exception Handling", "Warning: Page_Load.", ae);
    }
}
 
// A TraceContextEventHandler for the TraceFinished event.
void OnTraceFinished(object sender, TraceContextEventArgs e)
{
    TraceContextRecord r = null;    
    
    // Iterate through the collection of trace records and write 
    // them to the response stream.
    foreach(object o in e.TraceRecords)
    { 
        r = (TraceContextRecord)o;
        if (r.IsWarning) {
            Response.Write(String.Format("warning message: {0} <BR>", r.Message));
        }
        else {
            Response.Write(String.Format("error message: {0} <BR>", r.Message));
        }

    }
}       
</script>

<%@ Page language="VB" Trace="true" %>
<script runat="server">
' The Page_Load method.
Private Sub Page_Load(sender As Object, e As EventArgs)

    ' Register a handler for the TraceFinished event.
    AddHandler Trace.TraceFinished, AddressOf OnTraceFinished

    Try 
    Dim ae As New ArgumentException("Trace Test")
        Throw ae
    
    catch ioe As InvalidOperationException
        ' You can write an error trace message using the Write method.
        Trace.Write("Exception Handling", "Exception: Page_Load.", ioe)
    
    Catch ae As ArgumentException
        ' You can write a warning trace message using the Warn method.
        Trace.Warn("Exception Handling", "Warning: Page_Load.", ae)

    End Try

End Sub ' Page_Load
 
' A TraceContextEventHandler for the TraceFinished event.
Private Sub OnTraceFinished(sender As Object, e As TraceContextEventArgs)

    Dim r As TraceContextRecord
    Dim o As Object
    
    ' Iterate through the collection of trace records and write 
    ' them to the response stream.

    For Each o In e.TraceRecords
        r = CType(o, TraceContextRecord)
    If r.IsWarning Then
            Response.Write(String.Format("warning message: {0} <BR>", r.Message))
        Else
            Response.Write(String.Format("error message: {0} <BR>", r.Message))
        End If
    Next

End Sub	' OnTraceFinished
</script>

Commenti

Ogni volta che viene chiamato il Write metodo, viene aggiunto un TraceContext messaggio di traccia alla TraceRecords raccolta messaggi, accessibile quando si gestisce l'evento TraceFinished . Il messaggio viene aggiunto con la relativa IsWarning proprietà impostata su falsee la ErrorInfo proprietà è impostata sull'oggetto passato dal errorInfo parametro .

Vedi anche

Si applica a

Condividi tramite

TraceContext.Write Metodo

Definizione

Overload

Write(String)

Parametri

Commenti

Vedi anche

Si applica a

Write(String, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Write(String, String, Exception)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive