TraceContext.Write Metodo

Definizione

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

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

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

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