TraceContext.Write Método

Definición

Escribe información de seguimiento en el registro de seguimiento.

Sobrecargas

Write(String)

Escribe un mensaje de seguimiento en el registro de seguimiento.

Write(String, String)

Escribe información de seguimiento en el registro de seguimiento, incluidos un mensaje y todas las categorías definidas por el usuario.

Write(String, String, Exception)

Escribe información de seguimiento en el registro de seguimiento, incluidos todos los mensajes de seguimiento, las categorías definidas por el usuario y la información de errores.

Write(String)

Escribe un mensaje de seguimiento en el registro de seguimiento.

public:
 void Write(System::String ^ message);
public void Write (string message);
member this.Write : string -> unit
Public Sub Write (message As String)

Parámetros

message
String

Mensaje de seguimiento que se va a escribir en el registro.

Comentarios

Cada vez que se llama al Write método , se agrega un TraceContext mensaje de seguimiento a la TraceRecords colección messages, al que se puede acceder cuando se controla el TraceFinished evento. El mensaje se agrega con su IsWarning propiedad establecida en false y su ErrorInfo propiedad establecida en null.

Consulte también

Se aplica a

Write(String, String)

Escribe información de seguimiento en el registro de seguimiento, incluidos un mensaje y todas las categorías definidas por el usuario.

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)

Parámetros

category
String

Categoría de seguimiento que recibe el mensaje.

message
String

Mensaje de seguimiento que se va a escribir en el registro.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar al Write método para escribir un mensaje de seguimiento de error en el registro de seguimiento. En este ejemplo, el delegado recorre en iteración los mensajes de seguimiento y los escribe como una tabla HTML; Sin embargo, puede escribir la misma información en una base de datos o en un consumidor de herramientas de generación de perfiles.

<%@ 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>

Comentarios

Cada vez que se llama al Write método , se agrega un TraceContext mensaje de seguimiento a la TraceRecords colección messages, al que se puede acceder cuando se controla el TraceFinished evento. El mensaje se agrega con su IsWarning propiedad establecida en false y su ErrorInfo propiedad establecida en null.

Consulte también

Se aplica a

Write(String, String, Exception)

Escribe información de seguimiento en el registro de seguimiento, incluidos todos los mensajes de seguimiento, las categorías definidas por el usuario y la información de errores.

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)

Parámetros

category
String

Categoría de seguimiento que recibe el mensaje.

message
String

Mensaje de seguimiento que se va a escribir en el registro.

errorInfo
Exception

Exception que contiene información sobre el error.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar al Write método para escribir un mensaje de seguimiento de error en el registro de seguimiento. En este ejemplo, se realiza un seguimiento de excepciones diferentes como errores y advertencias. Cuando la página produce un ArgumentException, escribe un mensaje de advertencia mediante el Warn método . Cuando la página produce un InvalidOperationException, escribe un mensaje de error mediante el Write método .

<%@ 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>

Comentarios

Cada vez que se llama al Write método , se agrega un TraceContext mensaje de seguimiento a la TraceRecords colección messages, al que se puede acceder cuando se controla el TraceFinished evento. El mensaje se agrega con su IsWarning propiedad establecida en falsey la ErrorInfo propiedad se establece en el objeto pasado por el errorInfo parámetro .

Consulte también

Se aplica a