Sdílet prostřednictvím

Log.WriteException Metoda

  • Reference

Definice

Obor názvů:
Microsoft.VisualBasic.Logging
Sestavení:
Microsoft.VisualBasic.dll
Sestavení:
Microsoft.VisualBasic.Forms.dll

Zapíše informace o výjimce do naslouchacích procesů protokolů aplikace.

Přetížení

WriteException(Exception)

Zapíše informace o výjimce do naslouchacích procesů protokolů aplikace.
WriteException(Exception, TraceEventType, String)

Zapíše informace o výjimce do naslouchacích procesů protokolů aplikace.
WriteException(Exception, TraceEventType, String, Int32)

Zapíše informace o výjimce do naslouchacích procesů protokolů aplikace.

WriteException(Exception)

Zapíše informace o výjimce do naslouchacích procesů protokolů aplikace.

public:
 void WriteException(Exception ^ ex);
public void WriteException (Exception ex);
member this.WriteException : Exception -> unit
Public Sub WriteException (ex As Exception)

Parametry

ex
Exception

Povinná hodnota. Výjimka protokolu.

Výjimky

ArgumentNullException

ex je Nothing.

SecurityException

Kód s částečnou důvěryhodností volá metodu , ale zapisuje do naslouchacího procesu protokolu událostí, který vyžaduje úplný vztah důvěryhodnosti.

Příklady

Tento příklad ukazuje, jak použít metodu My.Application.Log.WriteException k protokolování výjimek. Zrušením komentování Dim řádků a MsgBox způsobíte NullReferenceException výjimku. Další informace najdete v tématu Postupy: Protokolování výjimek.

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

Tento příklad kódu lze spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteException na pro My.Log.WriteException webové aplikace.

Poznámky

Metoda WriteException zapisuje informace obsažené ve výjimce do naslouchacích procesů protokolu událostí aplikace.

V klientských aplikacích Log je objekt dostupný prostřednictvím objektu My.Application.Log . Ve webových aplikacích Log je objekt dostupný prostřednictvím objektu My.Log .

Informace o tom, které naslouchací procesy protokolu přijímají WriteException zprávy metody, najdete v tématu Návod: Určení, kam my.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolů můžete změnit. Další informace najdete v tématu Práce s protokoly aplikací.

Pro přetížení, která nepřebírají id argument , je identifikátor zapsaný do protokolu definován v následující tabulce.

severity Výchozí id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

Následující tabulka uvádí příklady úloh zahrnujících metodu WriteException .

Záměr Seznamte se s 
Zapište informace o výjimce do naslouchacích procesů protokolu událostí aplikace. Postupy: Protokolování výjimek
Určete, kam Log se zapisují informace. Návod: Zjištění, kam objekt My.Application.Log zapisuje informace

Dostupnost podle typu projektu

Typ projektu K dispozici.
Aplikace pro systém Windows Ano
Knihovna tříd Ano
Konzolová aplikace Ano
Knihovna ovládacích prvků Windows Ano
Knihovna webových ovládacích prvků No
Služba systému Windows Ano
Webu Ano

Viz také

Platí pro

WriteException(Exception, TraceEventType, String)

Zapíše informace o výjimce do naslouchacích procesů protokolů aplikace.

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)

Parametry

ex
Exception

Povinná hodnota. Výjimka protokolu.

severity
TraceEventType

Typ zprávy. Ve výchozím nastavení . Error

additionalInfo
String

Řetězec, který se má připojit ke zprávě. Ve výchozím nastavení se jedná o prázdný řetězec.

Výjimky

ArgumentNullException

ex je Nothing.

InvalidEnumArgumentException

Typ zprávy není jednou z hodnot výčtu TraceEventType .

SecurityException

Kód s částečnou důvěryhodností volá metodu , ale zapisuje do naslouchacího procesu protokolu událostí, který vyžaduje úplný vztah důvěryhodnosti.

Příklady

Tento příklad ukazuje, jak použít metodu My.Application.Log.WriteException k protokolování výjimek. Zrušením komentování Dim řádků a MsgBox způsobíte NullReferenceException výjimku. Další informace najdete v tématu Postupy: Protokolování výjimek.

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

Tento příklad kódu lze spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteException na pro My.Log.WriteException webové aplikace.

Poznámky

Metoda WriteException zapisuje informace obsažené ve výjimce do naslouchacích procesů protokolu událostí aplikace.

V klientských aplikacích Log je objekt dostupný prostřednictvím objektu My.Application.Log . Ve webových aplikacích Log je objekt dostupný prostřednictvím objektu My.Log .

Informace o tom, které naslouchací procesy protokolu přijímají WriteException zprávy metody, najdete v tématu Návod: Určení, kam my.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolů můžete změnit. Další informace najdete v tématu Práce s protokoly aplikací.

Pro přetížení, která nepřebírají id argument , je identifikátor zapsaný do protokolu definován v následující tabulce.

severity Výchozí id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

Následující tabulka uvádí příklady úloh zahrnujících metodu WriteException .

Záměr Seznamte se s 
Zapište informace o výjimce do naslouchacích procesů protokolu událostí aplikace. Postupy: Protokolování výjimek
Určete, kam Log se zapisují informace. Návod: Zjištění, kam objekt My.Application.Log zapisuje informace

Dostupnost podle typu projektu

Typ projektu K dispozici.
Aplikace pro systém Windows Ano
Knihovna tříd Ano
Konzolová aplikace Ano
Knihovna ovládacích prvků Windows Ano
Knihovna webových ovládacích prvků No
Služba systému Windows Ano
Webu Ano

Viz také

Platí pro

WriteException(Exception, TraceEventType, String, Int32)

Zapíše informace o výjimce do naslouchacích procesů protokolů aplikace.

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)

Parametry

ex
Exception

Povinná hodnota. Výjimka protokolu.

severity
TraceEventType

Typ zprávy. Ve výchozím nastavení . Error

additionalInfo
String

Řetězec, který se má připojit ke zprávě. Ve výchozím nastavení se jedná o prázdný řetězec.

id
Int32

Identifikátor zprávy, který se obvykle používá ke korelaci. Ve výchozím nastavení se vztahuje k entryType , jak je popsáno v tabulce v oddílu Poznámky.

Výjimky

ArgumentNullException

ex je Nothing.

InvalidEnumArgumentException

Typ zprávy není jednou z hodnot výčtu TraceEventType .

SecurityException

Kód s částečnou důvěryhodností volá metodu , ale zapisuje do naslouchacího procesu protokolu událostí, který vyžaduje úplný vztah důvěryhodnosti.

Příklady

Tento příklad ukazuje, jak použít metodu My.Application.Log.WriteException k protokolování výjimek. Zrušením komentování Dim řádků a MsgBox způsobíte NullReferenceException výjimku. Další informace najdete v tématu Postupy: Protokolování výjimek.

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

Tento příklad kódu lze spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteException na pro My.Log.WriteException webové aplikace.

Poznámky

Metoda WriteException zapisuje informace obsažené ve výjimce do naslouchacích procesů protokolu událostí aplikace.

V klientských aplikacích Log je objekt dostupný prostřednictvím objektu My.Application.Log . Ve webových aplikacích Log je objekt dostupný prostřednictvím objektu My.Log .

Informace o tom, které naslouchací procesy protokolu přijímají WriteException zprávy metody, najdete v tématu Návod: Určení, kam my.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolů můžete změnit. Další informace najdete v tématu Práce s protokoly aplikací.

Pro přetížení, která nepřebírají id argument , je identifikátor zapsaný do protokolu definován v následující tabulce.

severity Výchozí id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

Následující tabulka uvádí příklady úloh zahrnujících metodu WriteException .

Záměr Seznamte se s 
Zapište informace o výjimce do naslouchacích procesů protokolu událostí aplikace. Postupy: Protokolování výjimek
Určete, kam Log se zapisují informace. Návod: Zjištění, kam objekt My.Application.Log zapisuje informace

Dostupnost podle typu projektu

Typ projektu K dispozici.
Aplikace pro systém Windows Ano
Knihovna tříd Ano
Konzolová aplikace Ano
Knihovna ovládacích prvků Windows Ano
Knihovna webových ovládacích prvků No
Služba systému Windows Ano
Webu Ano

Viz také

Platí pro