Log.WriteException Methode

Definition

Namespace:: Microsoft.VisualBasic.Logging

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

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 Ausnahmeinformationen in die Protokolllistener der Anwendung.

Überlädt

Name	Beschreibung
WriteException(Exception)	Schreibt Ausnahmeinformationen in die Protokolllistener der Anwendung.
WriteException(Exception, TraceEventType, String)	Schreibt Ausnahmeinformationen in die Protokolllistener der Anwendung.
WriteException(Exception, TraceEventType, String, Int32)	Schreibt Ausnahmeinformationen in die Protokolllistener der Anwendung.

WriteException(Exception)

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Schreibt Ausnahmeinformationen in die Protokolllistener 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

Required. Ausnahme zum Protokollieren.

Ausnahmen

ArgumentNullException

ex ist Nothing.

SecurityException

Code mit teilweiser Vertrauensstellung ruft die Methode auf, schreibt jedoch in einen Ereignisprotokolllistener, der volle Vertrauenswürdige erfordert.

Beispiele

In diesem Beispiel wird gezeigt, wie Die My.Application.Log.WriteException Methode zum Protokollieren von Ausnahmen verwendet wird. Heben Sie die Kommentare und DimMsgBox Zeilen auf, um eine NullReferenceException Ausnahme zu verursachen. Weitere Informationen finden Sie unter How to: Log Exceptions.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. My.Application.Log.WriteException Für Webanwendungen ändernMy.Log.WriteException.

Hinweise

Die WriteException Methode schreibt die informationen, die in einer Ausnahme für die Ereignisprotokolllistener der Anwendung enthalten sind.

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

Informationen dazu, welche Protokolllistener die Nachrichten der WriteException Methode empfangen, finden Sie unter Walkthrough: Determining Where My.Application.Log Writes Information. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Bei Überladungen, die das id Argument nicht verwenden, 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.

To	Siehe
Schreiben Sie Ausnahmeinformationen in die Ereignisprotokolllistener der Anwendung.	Vorgehensweise: Protokollieren von Ausnahmen
Bestimmen Sie, wo `Log` Informationen geschrieben werden.	Anleitung: Ermitteln, wo My.Application.Log Informationen ablegt

Verfügbarkeit nach Projekttyp

Projekttyp	Available
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Websteuerelementbibliothek	No
Windows-Dienst	Ja
Website	Ja

Weitere Informationen

Gilt für:

WriteException(Exception, TraceEventType, String)

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Schreibt Ausnahmeinformationen in die Protokolllistener 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

Required. Ausnahme zum Protokollieren.

severity: TraceEventType

Der Typ der Nachricht. Standardmäßig ist dies Error.

additionalInfo: String

Zeichenfolge, die an die Nachricht angefügt werden soll. Standardmäßig ist dies eine leere Zeichenfolge.

Ausnahmen

ArgumentNullException

ex ist Nothing.

InvalidEnumArgumentException

Der Nachrichtentyp ist keiner der TraceEventType Enumerationswerte.

SecurityException

Code mit teilweiser Vertrauensstellung ruft die Methode auf, schreibt jedoch in einen Ereignisprotokolllistener, der volle Vertrauenswürdige erfordert.

Beispiele

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. My.Application.Log.WriteException Für Webanwendungen ändernMy.Log.WriteException.

Hinweise

Die WriteException Methode schreibt die informationen, die in einer Ausnahme für die Ereignisprotokolllistener der Anwendung enthalten sind.

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

Bei Überladungen, die das id Argument nicht verwenden, 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.

To	Siehe
Schreiben Sie Ausnahmeinformationen in die Ereignisprotokolllistener der Anwendung.	Vorgehensweise: Protokollieren von Ausnahmen
Bestimmen Sie, wo `Log` Informationen geschrieben werden.	Anleitung: Ermitteln, wo My.Application.Log Informationen ablegt

Verfügbarkeit nach Projekttyp

Projekttyp	Available
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Websteuerelementbibliothek	No
Windows-Dienst	Ja
Website	Ja

Weitere Informationen

Gilt für:

WriteException(Exception, TraceEventType, String, Int32)

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Quelle:: Log.vb

Schreibt Ausnahmeinformationen in die Protokolllistener 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

Required. Ausnahme zum Protokollieren.

severity: TraceEventType

Der Typ der Nachricht. Standardmäßig ist dies Error.

additionalInfo: String

Zeichenfolge, die an die Nachricht angefügt werden soll. Standardmäßig ist dies eine leere Zeichenfolge.

id: Int32

Nachrichtenbezeichner, der in der Regel für Korrelation verwendet wird. In Bezug auf entryType die in der Tabelle im Abschnitt "Hinweise" beschriebene Standardeinstellung.

Ausnahmen

ArgumentNullException

ex ist Nothing.

InvalidEnumArgumentException

Der Nachrichtentyp ist keiner der TraceEventType Enumerationswerte.

SecurityException

Code mit teilweiser Vertrauensstellung ruft die Methode auf, schreibt jedoch in einen Ereignisprotokolllistener, der volle Vertrauenswürdige erfordert.

Beispiele

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. My.Application.Log.WriteException Für Webanwendungen ändernMy.Log.WriteException.

Hinweise

Die WriteException Methode schreibt die informationen, die in einer Ausnahme für die Ereignisprotokolllistener der Anwendung enthalten sind.

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

Bei Überladungen, die das id Argument nicht verwenden, 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.

To	Siehe
Schreiben Sie Ausnahmeinformationen in die Ereignisprotokolllistener der Anwendung.	Vorgehensweise: Protokollieren von Ausnahmen
Bestimmen Sie, wo `Log` Informationen geschrieben werden.	Anleitung: Ermitteln, wo My.Application.Log Informationen ablegt

Verfügbarkeit nach Projekttyp

Projekttyp	Available
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Websteuerelementbibliothek	No
Windows-Dienst	Ja
Website	Ja

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?