Log.WriteException Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.Logging

Sestavení:

Microsoft.VisualBasic.Forms.dll

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

Přetížení

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

WriteException(Exception)

Zdroj:

Log.vb

Zapíše informace o výjimce do naslouchacích procesů protokolu 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

Required. Výjimka pro protokol.

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šte Dim komentář a MsgBox řádky, aby způsobily NullReferenceException výjimku. Další informace naleznete v tématu Postupy: Protokolování výjimek.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Tento příklad kódu se může spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteException nastavení My.Log.WriteException webových aplikací.

Poznámky

Metoda WriteException zapíše informace obsažené v výjimce na naslouchací procesy 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 části Návod: Určení, kde My.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolu můžete změnit. Další informace naleznete 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 úkolů zahrnujících metodu WriteException .

To	Podívejte se
Zapište informace o výjimce do naslouchacích procesů protokolu událostí aplikace.	Postupy: Protokolování výjimek
Určete, kde Log se zapisují informace.	Návod: Určení, kde my.application.log zapisuje informace

Dostupnost podle typu projektu

Typ projektu	Available
Aplikace pro systém Windows	Yes
Knihovna tříd	Yes
Konzolová aplikace	Yes
Knihovna ovládacích prvků systému Windows	Yes
Knihovna webových ovládacích prvků	No
Služba systému Windows	Yes
Web	Yes

Viz také

• Exception
• TraceEventType
• Objekty (Visual Basic)
• Working with Application Logs in Visual Basic
• W: Protokolování výjimek v Visual Basic
• Návod: Určení, kde my.application.log zapisuje informace

WriteException(Exception, TraceEventType, String)

Zdroj:

Log.vb

Zapíše informace o výjimce do naslouchacích procesů protokolu 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

Required. Výjimka pro protokol.

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šte Dim komentář a MsgBox řádky, aby způsobily NullReferenceException výjimku. Další informace naleznete v tématu Postupy: Protokolování výjimek.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Tento příklad kódu se může spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteException nastavení My.Log.WriteException webových aplikací.

Poznámky

Metoda WriteException zapíše informace obsažené v výjimce na naslouchací procesy 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 části Návod: Určení, kde My.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolu můžete změnit. Další informace naleznete 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 úkolů zahrnujících metodu WriteException .

To	Podívejte se
Zapište informace o výjimce do naslouchacích procesů protokolu událostí aplikace.	Postupy: Protokolování výjimek
Určete, kde Log se zapisují informace.	Návod: Určení, kde my.application.log zapisuje informace

Dostupnost podle typu projektu

Typ projektu	Available
Aplikace pro systém Windows	Yes
Knihovna tříd	Yes
Konzolová aplikace	Yes
Knihovna ovládacích prvků systému Windows	Yes
Knihovna webových ovládacích prvků	No
Služba systému Windows	Yes
Web	Yes

Viz také

• Exception
• TraceEventType
• Objekty (Visual Basic)
• Working with Application Logs in Visual Basic
• W: Protokolování výjimek v Visual Basic
• Návod: Určení, kde my.application.log zapisuje informace

WriteException(Exception, TraceEventType, String, Int32)

Zdroj:

Log.vb

Zapíše informace o výjimce do naslouchacích procesů protokolu 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

Required. Výjimka pro protokol.

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, obvykle používaný pro korelaci. Ve výchozím nastavení souvisí s popisem entryType v tabulce v části 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šte Dim komentář a MsgBox řádky, aby způsobily NullReferenceException výjimku. Další informace naleznete v tématu Postupy: Protokolování výjimek.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Tento příklad kódu se může spustit pouze v rámci klientské aplikace. Změňte My.Application.Log.WriteException nastavení My.Log.WriteException webových aplikací.

Poznámky

Metoda WriteException zapíše informace obsažené v výjimce na naslouchací procesy 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 části Návod: Určení, kde My.Application.Log zapisuje informace. Výchozí naslouchací procesy protokolu můžete změnit. Další informace naleznete 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 úkolů zahrnujících metodu WriteException .

To	Podívejte se
Zapište informace o výjimce do naslouchacích procesů protokolu událostí aplikace.	Postupy: Protokolování výjimek
Určete, kde Log se zapisují informace.	Návod: Určení, kde my.application.log zapisuje informace

Dostupnost podle typu projektu

Typ projektu	Available
Aplikace pro systém Windows	Yes
Knihovna tříd	Yes
Konzolová aplikace	Yes
Knihovna ovládacích prvků systému Windows	Yes
Knihovna webových ovládacích prvků	No
Služba systému Windows	Yes
Web	Yes

Viz také

• Exception
• TraceEventType
• Objekty (Visual Basic)
• Working with Application Logs in Visual Basic
• W: Protokolování výjimek v Visual Basic
• Návod: Určení, kde my.application.log zapisuje informace