Log.WriteException Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> unitPublic Sub WriteException (ex As Exception)Parametry
- ex
- Exception
Povinná hodnota. Výjimka protokolu.
Výjimky
ex je Nothing.
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é
- Exception
- TraceEventType
- Objekty (Visual Basic)
- Práce s protokoly aplikací v jazyce Visual Basic
- Postupy: Protokolování výjimek v jazyce Visual Basic
- Návod: Zjištění, kam objekt My.Application.Log zapisuje informace
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 -> unitPublic 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
ex je Nothing.
Typ zprávy není jednou z hodnot výčtu TraceEventType .
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é
- Exception
- TraceEventType
- Objekty (Visual Basic)
- Práce s protokoly aplikací v jazyce Visual Basic
- Postupy: Protokolování výjimek v jazyce Visual Basic
- Návod: Zjištění, kam objekt My.Application.Log zapisuje informace
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 -> unitPublic 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
ex je Nothing.
Typ zprávy není jednou z hodnot výčtu TraceEventType .
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é
- Exception
- TraceEventType
- Objekty (Visual Basic)
- Práce s protokoly aplikací v jazyce Visual Basic
- Postupy: Protokolování výjimek v jazyce Visual Basic
- Návod: Zjištění, kam objekt My.Application.Log zapisuje informace
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro