Freigeben über


Log.WriteException Methode

Definition

Schreibt Ausnahmeinformationen in die Protokollüberwachung der Anwendung.

Überlädt

WriteException(Exception)

Schreibt Ausnahmeinformationen in die Protokollüberwachung der Anwendung.

WriteException(Exception, TraceEventType, String)

Schreibt Ausnahmeinformationen in die Protokollüberwachung der Anwendung.

WriteException(Exception, TraceEventType, String, Int32)

Schreibt Ausnahmeinformationen in die Protokollüberwachung der Anwendung.

WriteException(Exception)

Schreibt Ausnahmeinformationen in die Protokollüberwachung der Anwendung.

public:
 void WriteException(Exception ^ ex);
public void WriteException (Exception ex);
member this.WriteException : Exception -> unit
Public Sub WriteException (ex As Exception)

Parameter

ex
Exception

Erforderlich. Die zu protokollierende Ausnahme.

Ausnahmen

ex ist Nothing.

Teilweise vertrauenswürdiger Code ruft die Methode auf, schreibt jedoch in eine Ereignisprotokollüberwachung, die volle Vertrauenswürdigkeit erfordert.

Beispiele

In diesem Beispiel wird gezeigt, wie Die My.Application.Log.WriteException -Methode zum Protokollieren von Ausnahmen verwendet wird. Heben Sie die Auskommentierung der Zeilen Dim und MsgBox auf, um eine NullReferenceException-Ausnahme auszulösen. Weitere Informationen finden Sie unter Vorgehensweise: Protokollieren von Ausnahmen.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern Sie My.Application.Log.WriteException für Webanwendungen in My.Log.WriteException .

Hinweise

Die WriteException -Methode schreibt die in einer Ausnahme enthaltenen Informationen in die Ereignisprotokolllistener der Anwendung.

In Clientanwendungen ist das Log Objekt über das My.Application.Log -Objekt verfügbar. In Webanwendungen ist das Log Objekt über das My.Log -Objekt verfügbar.

Informationen dazu, welche Protokolllistener die Meldungen der WriteException Methode empfangen, finden Sie unter Exemplarische Vorgehensweise: Bestimmen, wo My.Application.Log Informationen schreibt. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Für Überladungen, die das id Argument nicht annehmen, wird der in das Protokoll geschriebene Bezeichner durch die folgende Tabelle definiert.

severity Standard id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die WriteException -Methode betreffen.

Beschreibung Siehe
Schreiben von Ausnahmeinformationen in die Ereignisprotokolllistener der Anwendung. How to: Protokollieren von Ausnahmen
Bestimmen Sie, wohin Log Informationen schreibt. Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Nein
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für:

WriteException(Exception, TraceEventType, String)

Schreibt Ausnahmeinformationen in die Protokollüberwachung der Anwendung.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo);
public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo);
member this.WriteException : Exception * System.Diagnostics.TraceEventType * string -> unit
Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)

Parameter

ex
Exception

Erforderlich. Die zu protokollierende Ausnahme.

severity
TraceEventType

Der Typ der Meldung. Standardmäßig Error.

additionalInfo
String

Die Zeichenfolge, die an die Meldung angefügt werden soll. Dies ist standardmäßig eine leere Zeichenfolge.

Ausnahmen

ex ist Nothing.

Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.

Teilweise vertrauenswürdiger Code ruft die Methode auf, schreibt jedoch in eine Ereignisprotokollüberwachung, die volle Vertrauenswürdigkeit erfordert.

Beispiele

In diesem Beispiel wird gezeigt, wie Die My.Application.Log.WriteException -Methode zum Protokollieren von Ausnahmen verwendet wird. Heben Sie die Auskommentierung der Zeilen Dim und MsgBox auf, um eine NullReferenceException-Ausnahme auszulösen. Weitere Informationen finden Sie unter Vorgehensweise: Protokollieren von Ausnahmen.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern Sie My.Application.Log.WriteException für Webanwendungen in My.Log.WriteException .

Hinweise

Die WriteException -Methode schreibt die in einer Ausnahme enthaltenen Informationen in die Ereignisprotokolllistener der Anwendung.

In Clientanwendungen ist das Log Objekt über das My.Application.Log -Objekt verfügbar. In Webanwendungen ist das Log Objekt über das My.Log -Objekt verfügbar.

Informationen dazu, welche Protokolllistener die Meldungen der WriteException Methode empfangen, finden Sie unter Exemplarische Vorgehensweise: Bestimmen, wo My.Application.Log Informationen schreibt. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Für Überladungen, die das id Argument nicht annehmen, wird der in das Protokoll geschriebene Bezeichner durch die folgende Tabelle definiert.

severity Standard id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die WriteException -Methode betreffen.

Beschreibung Siehe
Schreiben von Ausnahmeinformationen in die Ereignisprotokolllistener der Anwendung. How to: Protokollieren von Ausnahmen
Bestimmen Sie, wohin Log Informationen schreibt. Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Nein
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für:

WriteException(Exception, TraceEventType, String, Int32)

Schreibt Ausnahmeinformationen in die Protokollüberwachung der Anwendung.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo, int id);
public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo, int id);
member this.WriteException : Exception * System.Diagnostics.TraceEventType * string * int -> unit
Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)

Parameter

ex
Exception

Erforderlich. Die zu protokollierende Ausnahme.

severity
TraceEventType

Der Typ der Meldung. Standardmäßig Error.

additionalInfo
String

Die Zeichenfolge, die an die Meldung angefügt werden soll. Dies ist standardmäßig eine leere Zeichenfolge.

id
Int32

Meldungs-ID, wird i. d. R. zur Korrelation verwendet. Standardmäßig bezieht sich auf, entryType wie in der Tabelle im Abschnitt Hinweise beschrieben.

Ausnahmen

ex ist Nothing.

Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.

Teilweise vertrauenswürdiger Code ruft die Methode auf, schreibt jedoch in eine Ereignisprotokollüberwachung, die volle Vertrauenswürdigkeit erfordert.

Beispiele

In diesem Beispiel wird gezeigt, wie Die My.Application.Log.WriteException -Methode zum Protokollieren von Ausnahmen verwendet wird. Heben Sie die Auskommentierung der Zeilen Dim und MsgBox auf, um eine NullReferenceException-Ausnahme auszulösen. Weitere Informationen finden Sie unter Vorgehensweise: Protokollieren von Ausnahmen.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern Sie My.Application.Log.WriteException für Webanwendungen in My.Log.WriteException .

Hinweise

Die WriteException -Methode schreibt die in einer Ausnahme enthaltenen Informationen in die Ereignisprotokolllistener der Anwendung.

In Clientanwendungen ist das Log Objekt über das My.Application.Log -Objekt verfügbar. In Webanwendungen ist das Log Objekt über das My.Log -Objekt verfügbar.

Informationen dazu, welche Protokolllistener die Meldungen der WriteException Methode empfangen, finden Sie unter Exemplarische Vorgehensweise: Bestimmen, wo My.Application.Log Informationen schreibt. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Für Überladungen, die das id Argument nicht annehmen, wird der in das Protokoll geschriebene Bezeichner durch die folgende Tabelle definiert.

severity Standard id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die WriteException -Methode betreffen.

Beschreibung Siehe
Schreiben von Ausnahmeinformationen in die Ereignisprotokolllistener der Anwendung. How to: Protokollieren von Ausnahmen
Bestimmen Sie, wohin Log Informationen schreibt. Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Nein
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für: