TraceContext.Write Método

Definição

Grava informações de rastreamento no log de rastreamento.

Sobrecargas

Write(String)

Grava uma mensagem de rastreamento no log de rastreamento.

Write(String, String)

Grava informações de rastreamento no log de rastreamento, incluindo uma mensagem e as categorias definidas pelo usuário.

Write(String, String, Exception)

Grava informações no log de rastreamento, incluindo quaisquer categorias definidas pelo usuário, mensagens de rastreamento e informações de erro.

Write(String)

Grava uma mensagem de rastreamento no log de rastreamento.

C#
public void Write (string message);

Parâmetros

message
String

A mensagem de rastreamento a ser gravada no log.

Comentários

Sempre que o Write método é chamado, uma TraceContext mensagem de rastreamento é adicionada à TraceRecords coleção de mensagens, que é acessível quando você manipula o TraceFinished evento. A mensagem é adicionada com sua IsWarning propriedade definida false como e sua ErrorInfo propriedade definida nullcomo .

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Write(String, String)

Grava informações de rastreamento no log de rastreamento, incluindo uma mensagem e as categorias definidas pelo usuário.

C#
public void Write (string category, string message);

Parâmetros

category
String

A categoria de rastreamento que recebe a mensagem.

message
String

A mensagem de rastreamento a ser gravada no log.

Exemplos

O exemplo de código a seguir demonstra como chamar o Write método para gravar uma mensagem de rastreamento de erro no log de rastreamento. Neste exemplo, o delegado itera pelas mensagens de rastreamento e as grava como uma tabela HTML; no entanto, você pode gravar as mesmas informações em um banco de dados ou em um consumidor de ferramenta de criação de perfil.

ASP.NET (C#)
<%@ 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>

Comentários

Sempre que o Write método é chamado, uma TraceContext mensagem de rastreamento é adicionada à TraceRecords coleção de mensagens, que é acessível quando você manipula o TraceFinished evento. A mensagem é adicionada com sua IsWarning propriedade definida false como e sua ErrorInfo propriedade definida nullcomo .

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Write(String, String, Exception)

Grava informações no log de rastreamento, incluindo quaisquer categorias definidas pelo usuário, mensagens de rastreamento e informações de erro.

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

Parâmetros

category
String

A categoria de rastreamento que recebe a mensagem.

message
String

A mensagem de rastreamento a ser gravada no log.

errorInfo
Exception

Um Exception que contém informações sobre o erro.

Exemplos

O exemplo de código a seguir demonstra como chamar o Write método para gravar uma mensagem de rastreamento de erro no log de rastreamento. Neste exemplo, diferentes exceções são rastreadas como erros e avisos. Quando a página lança um ArgumentException, ela grava uma mensagem de aviso usando o Warn método . Quando a página lança um InvalidOperationException, ela grava uma mensagem de erro usando o Write método .

ASP.NET (C#)
<%@ 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>

Comentários

Sempre que o Write método é chamado, uma TraceContext mensagem de rastreamento é adicionada à TraceRecords coleção de mensagens, que é acessível quando você manipula o TraceFinished evento. A mensagem é adicionada com sua IsWarning propriedade definida falsecomo e a ErrorInfo propriedade é definida como o objeto passado pelo errorInfo parâmetro .

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1