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:

• Der Ausnahme- oder Meldungstyp ist Nothing (ArgumentNullException).

• Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte (InvalidEnumArgumentException).

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

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