TraceContext.Warn Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Escribe información de seguimiento en el registro de seguimiento. A diferencia de Write(String), todas las advertencias aparecen en el registro como texto de color rojo.

Sobrecargas

Warn(String)	Escribe un mensaje de seguimiento en el registro de seguimiento. Todas las advertencias aparecen en el registro como texto de color rojo.
Warn(String, String)	Escribe información de seguimiento en el registro de seguimiento, incluidos todos los mensajes de seguimiento y las categorías definidas por el usuario. Todas las advertencias aparecen en el registro como texto de color rojo.
Warn(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. Todas las advertencias aparecen en el registro como texto de color rojo.

Warn(String)

Escribe un mensaje de seguimiento en el registro de seguimiento. Todas las advertencias aparecen en el registro como texto de color rojo.

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

public void Warn (string message);

member this.Warn : string -> unit

Public Sub Warn (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 Warn método , se agrega un TraceContext mensaje de seguimiento a la TraceRecords colección de mensajes, al que se puede acceder cuando se controla el TraceFinished evento. El mensaje se agrega con su IsWarning propiedad establecida en true y su ErrorInfo propiedad establecida en null.

Consulte también

• Información general sobre la traza de ASP.NET

Warn(String, String)

Escribe información de seguimiento en el registro de seguimiento, incluidos todos los mensajes de seguimiento y las categorías definidas por el usuario. Todas las advertencias aparecen en el registro como texto de color rojo.

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

public void Warn (string category, string message);

member this.Warn : string * string -> unit

Public Sub Warn (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.

Comentarios

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

Consulte también

• Información general sobre la traza de ASP.NET

Warn(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. Todas las advertencias aparecen en el registro como texto de color rojo.

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

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

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

Public Sub Warn (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 las distintas excepciones 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 Warn método , se agrega un TraceContext mensaje de seguimiento a la TraceRecords colección de mensajes, al que se puede acceder cuando se controla el TraceFinished evento. El mensaje se agrega con su IsWarning propiedad establecida trueen y la ErrorInfo propiedad se establece en el objeto pasado por el errorInfo parámetro .

Consulte también

• Exception
• Información general sobre la traza de ASP.NET