Aracılığıyla paylaş


TraceContext.Write Yöntem

Tanım

İzleme bilgilerini izleme günlüğüne yazar.

Aşırı Yüklemeler

Write(String)

İzleme günlüğüne bir izleme iletisi yazar.

Write(String, String)

bir ileti ve kullanıcı tanımlı kategoriler de dahil olmak üzere izleme bilgilerini izleme günlüğüne yazar.

Write(String, String, Exception)

Kullanıcı tanımlı kategoriler, izleme iletileri ve hata bilgileri de dahil olmak üzere izleme bilgilerini izleme günlüğüne yazar.

Write(String)

İzleme günlüğüne bir izleme iletisi yazar.

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

Parametreler

message
String

Günlüğe yazacak izleme iletisi.

Açıklamalar

Write Yöntem her çağrıldığında, olayı işlediğiniz zaman erişilebilen messages koleksiyonuna TraceRecordsTraceFinished bir TraceContext izleme iletisi eklenir. İleti, özelliği olarak ve ErrorInfofalse özelliği olarak ayarlanmış şekilde nulleklenirIsWarning.

Ayrıca bkz.

Şunlara uygulanır

Write(String, String)

bir ileti ve kullanıcı tanımlı kategoriler de dahil olmak üzere izleme bilgilerini izleme günlüğüne yazar.

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)

Parametreler

category
String

İletiyi alan izleme kategorisi.

message
String

Günlüğe yazacak izleme iletisi.

Örnekler

Aşağıdaki kod örneği, izleme günlüğüne hata izleme iletisi yazmak için yönteminin nasıl çağrılduğunu Write gösterir. Bu örnekte, temsilci izleme iletileri arasında yinelenir ve bunları bir HTML tablosu olarak yazar; ancak, aynı bilgileri bir veritabanına veya profil oluşturma aracı tüketicisine yazabilirsiniz.

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

Açıklamalar

Write Yöntem her çağrıldığında, olayı işlediğiniz zaman erişilebilen messages koleksiyonuna TraceRecordsTraceFinished bir TraceContext izleme iletisi eklenir. İleti, özelliği olarak ve ErrorInfofalse özelliği olarak ayarlanmış şekilde nulleklenirIsWarning.

Ayrıca bkz.

Şunlara uygulanır

Write(String, String, Exception)

Kullanıcı tanımlı kategoriler, izleme iletileri ve hata bilgileri de dahil olmak üzere izleme bilgilerini izleme günlüğüne yazar.

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)

Parametreler

category
String

İletiyi alan izleme kategorisi.

message
String

Günlüğe yazacak izleme iletisi.

errorInfo
Exception

Exception Hata hakkında bilgi içeren bir.

Örnekler

Aşağıdaki kod örneği, izleme günlüğüne hata izleme iletisi yazmak için yönteminin nasıl çağrılduğunu Write gösterir. Bu örnekte farklı özel durumlar hata ve uyarı olarak izlenir. Sayfa bir ArgumentExceptionoluştururken yöntemini kullanarak Warn bir uyarı iletisi yazar. Sayfa bir InvalidOperationExceptionoluştururken yöntemini kullanarak Write bir hata iletisi yazar.

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

Açıklamalar

Write Yöntem her çağrıldığında, olayı işlediğiniz zaman erişilebilen messages koleksiyonuna TraceRecordsTraceFinished bir TraceContext izleme iletisi eklenir. İleti, özelliği olarak ayarlanmış falseşekilde eklenir IsWarning ve ErrorInfo özellik parametresi tarafından geçirilen nesneye errorInfo ayarlanır.

Ayrıca bkz.

Şunlara uygulanır