Log.WriteException Metódus

Definíció

Névtér:

Microsoft.VisualBasic.Logging

Szerelvény:

Microsoft.VisualBasic.Forms.dll

Kivételadatokat ír az alkalmazás naplófigyelőinek.

Túlterhelések

Name	Description
WriteException(Exception)	Kivételadatokat ír az alkalmazás naplófigyelőinek.
WriteException(Exception, TraceEventType, String)	Kivételadatokat ír az alkalmazás naplófigyelőinek.
WriteException(Exception, TraceEventType, String, Int32)	Kivételadatokat ír az alkalmazás naplófigyelőinek.

WriteException(Exception)

Forrás:

Log.vb

Kivételadatokat ír az alkalmazás naplófigyelőinek.

public:
 void WriteException(Exception ^ ex);

public void WriteException(Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

Paraméterek

ex

Exception

Kötelező. Kivétel a naplózáshoz.

Kivételek

ArgumentNullException

ex az Nothing.

SecurityException

A részleges megbízhatósággal rendelkező kód meghívja a metódust, de egy teljes megbízhatóságot igénylő eseménynapló-figyelőnek ír.

Példák

Ez a példa bemutatja, hogyan használhatja a metódust a My.Application.Log.WriteException kivételek naplózására. A kivételt Dim okozó sorok és MsgBox sorok felbontása NullReferenceException . További információ : Útmutató: Kivételek naplózása.

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

Ez a példakód csak egy ügyfélalkalmazáson belül futtatható. Váltás My.Application.Log.WriteException webalkalmazásokra My.Log.WriteException .

Megjegyzések

A WriteException metódus egy kivételben szereplő információt ír az alkalmazás eseménynapló-figyelőinek.

Az ügyfélalkalmazásokban az Log objektum az My.Application.Log objektumon keresztül érhető el. Webalkalmazásokban az Log objektum az My.Log objektumon keresztül érhető el.

Annak megállapításához, hogy mely naplófigyelők kapják meg a WriteException metódus üzeneteit, tekintse meg az útmutatót: Where My.Application.Log Writes Information. Módosíthatja az alapértelmezett naplófigyelőket. További információ: Az alkalmazásnaplók használata.

Az argumentumot nem használó id túlterhelések esetén a naplóba írt azonosítót az alábbi táblázat határozza meg.

severity	Alapértelmezett id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

Az alábbi táblázat példákat sorol fel a metódust érintő tevékenységekre WriteException .

Címzett	Nézze
Írjon kivételadatokat az alkalmazás eseménynapló-figyelőinek.	Útmutató: Kivételek naplózása
Határozza meg, hogy hol Log írja az adatokat.	Útmutató: Hol tárolja a My.Application.Log az információkat

Rendelkezésre állás projekttípus szerint

Projekt típusa	Elérhető
Windows-alkalmazás	Yes
Osztálytár	Yes
Konzolalkalmazás	Yes
Windows-vezérlőtár	Yes
Webvezérlő-kódtár	No
Windows-szolgáltatás	Yes
Webhely	Yes

Lásd még

• Exception
• TraceEventType
• Objects (Visual Basic)
• Munka az alkalmazásnaplókkal a Visual Basic
• Hogyan is: Naplózási kivételek a Visual Basic
• Útmutató: Hol tárolja a My.Application.Log az információkat

WriteException(Exception, TraceEventType, String)

Forrás:

Log.vb

Kivételadatokat ír az alkalmazás naplófigyelőinek.

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)

Paraméterek

ex

Exception

Kötelező. Kivétel a naplózáshoz.

severity

TraceEventType

Az üzenet típusa. Alapértelmezés szerint. Error

additionalInfo

String

Az üzenethez fűzendő sztring. Alapértelmezés szerint ez egy üres sztring.

Kivételek

ArgumentNullException

ex az Nothing.

InvalidEnumArgumentException

Az üzenettípus nem tartozik az TraceEventType enumerálási értékek közé.

SecurityException

A részleges megbízhatósággal rendelkező kód meghívja a metódust, de egy teljes megbízhatóságot igénylő eseménynapló-figyelőnek ír.

Példák

Ez a példa bemutatja, hogyan használhatja a metódust a My.Application.Log.WriteException kivételek naplózására. A kivételt Dim okozó sorok és MsgBox sorok felbontása NullReferenceException . További információ : Útmutató: Kivételek naplózása.

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

Ez a példakód csak egy ügyfélalkalmazáson belül futtatható. Váltás My.Application.Log.WriteException webalkalmazásokra My.Log.WriteException .

Megjegyzések

A WriteException metódus egy kivételben szereplő információt ír az alkalmazás eseménynapló-figyelőinek.

Az ügyfélalkalmazásokban az Log objektum az My.Application.Log objektumon keresztül érhető el. Webalkalmazásokban az Log objektum az My.Log objektumon keresztül érhető el.

Annak megállapításához, hogy mely naplófigyelők kapják meg a WriteException metódus üzeneteit, tekintse meg az útmutatót: Where My.Application.Log Writes Information. Módosíthatja az alapértelmezett naplófigyelőket. További információ: Az alkalmazásnaplók használata.

Az argumentumot nem használó id túlterhelések esetén a naplóba írt azonosítót az alábbi táblázat határozza meg.

severity	Alapértelmezett id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

Az alábbi táblázat példákat sorol fel a metódust érintő tevékenységekre WriteException .

Címzett	Nézze
Írjon kivételadatokat az alkalmazás eseménynapló-figyelőinek.	Útmutató: Kivételek naplózása
Határozza meg, hogy hol Log írja az adatokat.	Útmutató: Hol tárolja a My.Application.Log az információkat

Rendelkezésre állás projekttípus szerint

Projekt típusa	Elérhető
Windows-alkalmazás	Yes
Osztálytár	Yes
Konzolalkalmazás	Yes
Windows-vezérlőtár	Yes
Webvezérlő-kódtár	No
Windows-szolgáltatás	Yes
Webhely	Yes

Lásd még

• Exception
• TraceEventType
• Objects (Visual Basic)
• Munka az alkalmazásnaplókkal a Visual Basic
• Hogyan is: Naplózási kivételek a Visual Basic
• Útmutató: Hol tárolja a My.Application.Log az információkat

WriteException(Exception, TraceEventType, String, Int32)

Forrás:

Log.vb

Kivételadatokat ír az alkalmazás naplófigyelőinek.

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)

Paraméterek

ex

Exception

Kötelező. Kivétel a naplózáshoz.

severity

TraceEventType

Az üzenet típusa. Alapértelmezés szerint. Error

additionalInfo

String

Az üzenethez fűzendő sztring. Alapértelmezés szerint ez egy üres sztring.

id

Int32

Általában korrelációhoz használt üzenetazonosító. Alapértelmezés szerint a entryType Megjegyzések szakaszban található táblázatban leírtaknak megfelelően.

Kivételek

ArgumentNullException

ex az Nothing.

InvalidEnumArgumentException

Az üzenettípus nem tartozik az TraceEventType enumerálási értékek közé.

SecurityException

A részleges megbízhatósággal rendelkező kód meghívja a metódust, de egy teljes megbízhatóságot igénylő eseménynapló-figyelőnek ír.

Példák

Ez a példa bemutatja, hogyan használhatja a metódust a My.Application.Log.WriteException kivételek naplózására. A kivételt Dim okozó sorok és MsgBox sorok felbontása NullReferenceException . További információ : Útmutató: Kivételek naplózása.

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

Ez a példakód csak egy ügyfélalkalmazáson belül futtatható. Váltás My.Application.Log.WriteException webalkalmazásokra My.Log.WriteException .

Megjegyzések

A WriteException metódus egy kivételben szereplő információt ír az alkalmazás eseménynapló-figyelőinek.

Az ügyfélalkalmazásokban az Log objektum az My.Application.Log objektumon keresztül érhető el. Webalkalmazásokban az Log objektum az My.Log objektumon keresztül érhető el.

Annak megállapításához, hogy mely naplófigyelők kapják meg a WriteException metódus üzeneteit, tekintse meg az útmutatót: Where My.Application.Log Writes Information. Módosíthatja az alapértelmezett naplófigyelőket. További információ: Az alkalmazásnaplók használata.

Az argumentumot nem használó id túlterhelések esetén a naplóba írt azonosítót az alábbi táblázat határozza meg.

severity	Alapértelmezett id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

Az alábbi táblázat példákat sorol fel a metódust érintő tevékenységekre WriteException .

Címzett	Nézze
Írjon kivételadatokat az alkalmazás eseménynapló-figyelőinek.	Útmutató: Kivételek naplózása
Határozza meg, hogy hol Log írja az adatokat.	Útmutató: Hol tárolja a My.Application.Log az információkat

Rendelkezésre állás projekttípus szerint

Projekt típusa	Elérhető
Windows-alkalmazás	Yes
Osztálytár	Yes
Konzolalkalmazás	Yes
Windows-vezérlőtár	Yes
Webvezérlő-kódtár	No
Windows-szolgáltatás	Yes
Webhely	Yes

Lásd még

• Exception
• TraceEventType
• Objects (Visual Basic)
• Munka az alkalmazásnaplókkal a Visual Basic
• Hogyan is: Naplózási kivételek a Visual Basic
• Útmutató: Hol tárolja a My.Application.Log az információkat