TraceContext.Write Método

Referencia

Definición

Espacio de nombres:: System.Web

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Información general sobre la traza de ASP.NET

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

Consulte también

Información general sobre la traza de ASP.NET

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

Consulte también

Se aplica a

Compartir vía

TraceContext.Write Método

Definición

Sobrecargas

Write(String)

Parámetros

Comentarios

Consulte también

Se aplica a

Write(String, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(String, String, Exception)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales