Bagikan melalui

TraceContext.Write Metode

  • Referensi

Definisi

Ruang nama:
System.Web
Rakitan:
System.Web.dll

Menulis informasi pelacakan ke log jejak.

Overload

Write(String)

Menulis pesan jejak ke log jejak.
Write(String, String)

Menulis informasi pelacakan ke log pelacakan, termasuk pesan dan kategori yang ditentukan pengguna.
Write(String, String, Exception)

Menulis informasi pelacakan ke log pelacakan, termasuk kategori yang ditentukan pengguna, pesan jejak, dan informasi kesalahan.

Write(String)

Menulis pesan jejak ke log jejak.

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

Parameter

message
String

Pesan pelacakan untuk menulis ke log.

Keterangan

Setiap kali metode dipanggil Write , TraceContext pesan pelacakan ditambahkan ke TraceRecords kumpulan pesan, yang dapat diakses saat Anda menangani TraceFinished peristiwa. Pesan ditambahkan dengan propertinya IsWarning diatur ke false dan propertinya ErrorInfo diatur ke null.

Lihat juga

Berlaku untuk

Write(String, String)

Menulis informasi pelacakan ke log pelacakan, termasuk pesan dan kategori yang ditentukan pengguna.

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)

Parameter

category
String

Kategori pelacakan yang menerima pesan.

message
String

Pesan pelacakan untuk menulis ke log.

Contoh

Contoh kode berikut menunjukkan cara memanggil Write metode untuk menulis pesan jejak kesalahan ke log jejak. Dalam contoh ini, delegasi melakukan iterasi melalui pesan pelacakan dan menulisnya sebagai tabel HTML; namun, Anda dapat menulis informasi yang sama ke database atau konsumen alat pembuatan profil.

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

Keterangan

Setiap kali metode dipanggil Write , TraceContext pesan pelacakan ditambahkan ke TraceRecords kumpulan pesan, yang dapat diakses saat Anda menangani TraceFinished peristiwa. Pesan ditambahkan dengan propertinya IsWarning diatur ke false dan propertinya ErrorInfo diatur ke null.

Lihat juga

Berlaku untuk

Write(String, String, Exception)

Menulis informasi pelacakan ke log pelacakan, termasuk kategori yang ditentukan pengguna, pesan jejak, dan informasi kesalahan.

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)

Parameter

category
String

Kategori pelacakan yang menerima pesan.

message
String

Pesan pelacakan untuk menulis ke log.

errorInfo
Exception

Yang Exception berisi informasi tentang kesalahan.

Contoh

Contoh kode berikut menunjukkan cara memanggil Write metode untuk menulis pesan jejak kesalahan ke log jejak. Dalam contoh ini, pengecualian yang berbeda dilacak sebagai kesalahan dan peringatan. Ketika halaman melempar ArgumentException, halaman menulis pesan peringatan menggunakan Warn metode . Ketika halaman melempar InvalidOperationException, halaman menulis pesan kesalahan menggunakan Write metode .

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

Keterangan

Setiap kali metode dipanggil Write , TraceContext pesan pelacakan ditambahkan ke TraceRecords kumpulan pesan, yang dapat diakses saat Anda menangani TraceFinished peristiwa. Pesan ditambahkan dengan propertinya IsWarning diatur ke false, dan ErrorInfo properti diatur ke objek yang diteruskan oleh errorInfo parameter .

Lihat juga

Berlaku untuk