Log.WriteException Methode
Definition
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 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 -> unitPublic Sub WriteException (ex As Exception)Parameter
- ex
- Exception
Erforderlich. Die zu protokollierende Ausnahme.
Ausnahmen
ex ist Nothing.
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
Gilt für:
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 -> unitPublic 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
ex ist Nothing.
Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.
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
Gilt für:
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 -> unitPublic 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
ex ist Nothing.
Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.
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
