TraceContext.Warn Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll. Im Gegensatz dazu Write(String)werden alle Warnungen im Protokoll als roter Text angezeigt.
Überlädt
| Name | Beschreibung |
|---|---|
| Warn(String) |
Schreibt eine Ablaufverfolgungsmeldung in das Ablaufverfolgungsprotokoll. Alle Warnungen werden im Protokoll als roter Text angezeigt. |
| Warn(String, String) |
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich aller benutzerdefinierten Kategorien und Ablaufverfolgungsmeldungen. Alle Warnungen werden im Protokoll als roter Text angezeigt. |
| Warn(String, String, Exception) |
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich benutzerdefinierter Kategorien, Ablaufverfolgungsmeldungen und Fehlerinformationen. Alle Warnungen werden im Protokoll als roter Text angezeigt. |
Warn(String)
Schreibt eine Ablaufverfolgungsmeldung in das Ablaufverfolgungsprotokoll. Alle Warnungen werden im Protokoll als roter Text angezeigt.
public:
void Warn(System::String ^ message);
public void Warn(string message);
member this.Warn : string -> unit
Public Sub Warn (message As String)
Parameter
- message
- String
Die Ablaufverfolgungsmeldung, die in das Protokoll geschrieben werden soll.
Hinweise
Jedes Mal, wenn die Warn Methode aufgerufen wird, wird der Nachrichtensammlung eine TraceContext Ablaufverfolgungsnachricht hinzugefügt TraceRecords , auf die beim Behandeln des TraceFinished Ereignisses zugegriffen werden kann. Die Nachricht wird mit seiner IsWarning Eigenschaftssatz und dessen ErrorInfo Eigenschaftssatz true hinzugefügt.null
Weitere Informationen
Gilt für:
Warn(String, String)
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich aller benutzerdefinierten Kategorien und Ablaufverfolgungsmeldungen. Alle Warnungen werden im Protokoll als roter Text angezeigt.
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)
Parameter
- category
- String
Die Ablaufverfolgungskategorie, die die Nachricht empfängt.
- message
- String
Die Ablaufverfolgungsmeldung, die in das Protokoll geschrieben werden soll.
Hinweise
Jedes Mal, wenn die Warn Methode aufgerufen wird, wird der Nachrichtensammlung eine TraceContext Ablaufverfolgungsnachricht hinzugefügt TraceRecords , auf die beim Behandeln des TraceFinished Ereignisses zugegriffen werden kann. Die Nachricht wird mit seiner IsWarning Eigenschaftssatz und dessen ErrorInfo Eigenschaftssatz true hinzugefügt.null
Weitere Informationen
Gilt für:
Warn(String, String, Exception)
Schreibt Ablaufverfolgungsinformationen in das Ablaufverfolgungsprotokoll, einschließlich benutzerdefinierter Kategorien, Ablaufverfolgungsmeldungen und Fehlerinformationen. Alle Warnungen werden im Protokoll als roter Text angezeigt.
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)
Parameter
- category
- String
Die Ablaufverfolgungskategorie, die die Nachricht empfängt.
- message
- String
Die Ablaufverfolgungsmeldung, die in das Protokoll geschrieben werden soll.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Write Methode aufgerufen wird, um eine Fehlermeldung in das Ablaufverfolgungsprotokoll zu schreiben. In diesem Beispiel werden unterschiedliche Ausnahmen als Fehler und Warnungen nachverfolgt. Wenn die Seite eine ArgumentExceptionFehlermeldung auslöst, schreibt sie eine Warnmeldung mithilfe der Warn Methode. Wenn die Seite eine InvalidOperationExceptionFehlermeldung auslöst, schreibt sie mithilfe der Write Methode eine Fehlermeldung.
<%@ 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>
Hinweise
Jedes Mal, wenn die Warn Methode aufgerufen wird, wird der Nachrichtensammlung eine TraceContext Ablaufverfolgungsnachricht hinzugefügt TraceRecords , auf die beim Behandeln des TraceFinished Ereignisses zugegriffen werden kann. Die Nachricht wird mit dem IsWarning Eigenschaftensatz truehinzugefügt, und die ErrorInfo Eigenschaft wird auf das objekt festgelegt, das errorInfo vom Parameter übergeben wird.