Log.WriteException Methode

Definition

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

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

ArgumentNullException

ex ist Nothing.

SecurityException

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

• Exception
• TraceEventType
• Objekte (Visual Basic)
• Arbeiten mit Anwendungsprotokollen in Visual Basic
• Gewusst wie: Protokollieren von Ausnahmen in Visual Basic
• Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

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

ArgumentNullException

ex ist Nothing.

InvalidEnumArgumentException

Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.

SecurityException

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

• Exception
• TraceEventType
• Objekte (Visual Basic)
• Arbeiten mit Anwendungsprotokollen in Visual Basic
• Gewusst wie: Protokollieren von Ausnahmen in Visual Basic
• Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

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

ArgumentNullException

ex ist Nothing.

InvalidEnumArgumentException

Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.

SecurityException

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

• Exception
• TraceEventType
• Objekte (Visual Basic)
• Arbeiten mit Anwendungsprotokollen in Visual Basic
• Gewusst wie: Protokollieren von Ausnahmen in Visual Basic
• Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt