Freigeben über


WriteException-Methode ("My.Application.Log" und "My.Log")

Aktualisiert: November 2007

Schreibt Ausnahmeinformationen in die Protokollüberwachungen der Anwendung.

' Usage
My.Application.Log.WriteException(ex)
My.Application.Log.WriteException(ex ,severity ,additionalInfo)
My.Application.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Web usage
My.Log.WriteException(ex)
My.Log.WriteException(ex ,severity ,additionalInfo)
My.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Declaration
Public Sub WriteException( _
   ByVal ex As System.Exception _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String, _
   ByVal id As Integer _
)

Parameter

  • ex
    Erforderlich. Die zu protokollierende Ausnahme.

  • severity
    Der Typ der Meldung. Standardmäßig Error.

  • additionalInfo
    Die an die Meldung anzufügende Zeichenfolge. Standardmäßig ist dies eine leere Zeichenfolge.

  • id
    Meldungsbezeichner, i. d. R. für Korrelation verwendet. Bezieht sich standardmäßig auf entryType, wie in der Tabelle im Abschnitt Hinweise beschrieben.

Ausnahmen

Die folgenden Bedingungen lösen eine Ausnahme aus:

Hinweise

Die WriteException-Methode schreibt die Informationen einer Ausnahme in die Protokollüberwachungen 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 über die Protokollüberwachungen, die Meldungen der WriteException-Methode empfangen, finden Sie unter Exemplarische Vorgehensweise: Bestimmen, wohin "My.Application.Log" Informationen schreibt. Sie können Standardprotokollüberwachungen ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen in Visual Basic.

Für Überladungen, die das id-Argument nicht akzeptieren, wird der in das Protokoll geschriebene Bezeichner in der folgenden 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

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der WriteException-Methode aufgeführt.

Zweck

Weitere Informationen finden Sie unter

Schreiben von Ausnahmeinformationen in die Ereignisprotokollüberwachungen der Anwendung

Gewusst wie: Protokollieren von Ausnahmen in Visual Basic

Bestimmen des Ziels, in das Log Informationen schreibt

Exemplarische Vorgehensweise: Bestimmen, wohin "My.Application.Log" Informationen schreibt

Beispiel

In diesem Beispiel wird die Verwendung der My.Application.Log.WriteException-Methode zum Protokollieren von Ausnahmen veranschaulicht. Heben Sie die Auskommentierung der Dim-Zeile und der MsgBox-Zeile auf, um eine NullReferenceException-Ausnahme zu verursachen. Weitere Informationen finden Sie unter Gewusst wie: Protokollieren von Ausnahmen in Visual Basic.

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 in einer Clientanwendung ausgeführt werden. Ändern Sie für Webanwendungen My.Application.Log.WriteException in My.Log.WriteException.

Anforderungen

Namespace:Microsoft.VisualBasic.Logging

Klasse:Log

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp

Verfügbar

Windows-Anwendung

Ja

Klassenbibliothek

Ja

Konsolenanwendung

Ja

Windows-Steuerelementbibliothek

Ja

Web-Steuerelementbibliothek

Nein

Windows-Dienst

Ja

Website

Ja

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Berechtigung

Beschreibung

FileIOPermission

Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Protokollieren von Ausnahmen in Visual Basic

Exemplarische Vorgehensweise: Bestimmen, wohin "My.Application.Log" Informationen schreibt

Konzepte

Arbeiten mit Anwendungsprotokollen in Visual Basic

Referenz

My.Application.Log-Objekt

My.Log-Objekt

System.Exception

System.Diagnostics.TraceEventType

Log.WriteException