TraceContext.Write Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

İ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 TraceRecords TraceFinished bir TraceContext izleme iletisi eklenir. İleti, özelliği olarak ve ErrorInfofalse özelliği olarak ayarlanmış şekilde nulleklenirIsWarning.

Ayrıca bkz.

ASP.NET İzlemeye Genel Bakış

Ş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

Ayrıca bkz.

ASP.NET İzlemeye Genel Bakış

Ş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 TraceRecords TraceFinished 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

Aracılığıyla paylaş

TraceContext.Write Yöntem

Tanım

Aşırı Yüklemeler

Write(String)

Parametreler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(String, String)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Write(String, String, Exception)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar