Log.WriteException Methode

Definition

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.dll

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 Sie die My.Application.Log.WriteException Methode zum Protokollieren von Ausnahmen verwenden. Heben Sie die Auskommentierung der Zeilen Dim und MsgBox auf, um eine NullReferenceException-Ausnahme auszulösen. Weitere Informationen finden Sie unter How to: Log Exceptions.

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

In diesem Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern sie My.Application.Log.WriteException My.Log.WriteException für Webanwendungen.

Hinweise

Die WriteException Methode schreibt die Informationen, die in einer Ausnahme der Ereignisprotokolllisten der Anwendung enthalten sind.

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

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

Für Überladungen, die das id Argument nicht übernehmen, wird der bezeichner, der in das Protokoll geschrieben wurde, 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 Vorgänge aufgeführt, die die WriteException Methode betreffen.

Beschreibung	Siehe
Schreiben Sie Ausnahmeinformationen in die Ereignisprotokolllisten 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 Project Typ

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

Siehe auch

• 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 Sie die My.Application.Log.WriteException Methode zum Protokollieren von Ausnahmen verwenden. Heben Sie die Auskommentierung der Zeilen Dim und MsgBox auf, um eine NullReferenceException-Ausnahme auszulösen. Weitere Informationen finden Sie unter How to: Log Exceptions.

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

In diesem Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern sie My.Application.Log.WriteException My.Log.WriteException für Webanwendungen.

Hinweise

Die WriteException Methode schreibt die Informationen, die in einer Ausnahme der Ereignisprotokolllisten der Anwendung enthalten sind.

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

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

Für Überladungen, die das id Argument nicht übernehmen, wird der bezeichner, der in das Protokoll geschrieben wurde, 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 Vorgänge aufgeführt, die die WriteException Methode betreffen.

Beschreibung	Siehe
Schreiben Sie Ausnahmeinformationen in die Ereignisprotokolllisten 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 Project Typ

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

Siehe auch

• 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. Ist standardmäßig mit entryType verknüpft, 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 How to: Log Exceptions.

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

In diesem Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern My.Application.Log.WriteException sie sich für My.Log.WriteException Webanwendungen.

Hinweise

Die WriteException Methode schreibt die Informationen, die in einer Ausnahme der Ereignisprotokolllisten der Anwendung enthalten sind.

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

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

Für Überladungen, die das id Argument nicht übernehmen, wird der bezeichner, der in das Protokoll geschrieben wurde, 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 Vorgänge aufgeführt, die die WriteException Methode betreffen.

Beschreibung	Siehe
Schreiben Sie Ausnahmeinformationen in die Ereignisprotokolllisten 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 Project Typ

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

Siehe auch

• 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