Log.WriteException Metod

Definition

Namnområde:

Microsoft.VisualBasic.Logging

Sammansättning:

Microsoft.VisualBasic.Forms.dll

Skriver undantagsinformation till programmets logglyssnare.

Överlagringar

Name	Description
WriteException(Exception)	Skriver undantagsinformation till programmets logglyssnare.
WriteException(Exception, TraceEventType, String)	Skriver undantagsinformation till programmets logglyssnare.
WriteException(Exception, TraceEventType, String, Int32)	Skriver undantagsinformation till programmets logglyssnare.

WriteException(Exception)

Källa:

Log.vb

Skriver undantagsinformation till programmets logglyssnare.

public:
 void WriteException(Exception ^ ex);

public void WriteException(Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

Parametrar

ex

Exception

Required. Undantag för loggning.

Undantag

ArgumentNullException

ex är Nothing.

SecurityException

Kod med partiellt förtroende anropar metoden, men skriver till en händelselogglyssnare som kräver fullständigt förtroende.

Exempel

Det här exemplet visar hur du använder My.Application.Log.WriteException metoden för att logga undantag. Avkommentering av raderna Dim och MsgBox för att orsaka ett NullReferenceException undantag. Mer information finns i Så här: Logga undantag.

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

Det här kodexemplet kan bara köras i ett klientprogram. Ändra My.Application.Log.WriteException till My.Log.WriteException för webbprogram.

Kommentarer

Metoden WriteException skriver informationen i ett undantag till programmets händelselogglyssnare.

I klientprogram är objektet Log tillgängligt via objektet My.Application.Log . I webbprogram är objektet Log tillgängligt via objektet My.Log .

Information om vilka logglyssnare WriteException som tar emot metodens meddelanden finns i Genomgång: Fastställa var my.application.log skriver information. Du kan ändra standardlogglyssnare. Mer information finns i Arbeta med programloggar.

För överlagringar som inte tar id argumentet definieras identifieraren som skrivits till loggen av följande tabell.

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

I följande tabell visas exempel på uppgifter som involverar WriteException metoden.

Till	Se
Skriv undantagsinformation till programmets händelselogglyssnare.	Anvisningar: Logga undantag
Avgör var Log skrivinformationen ska skrivas.	Genomgång: Fastställa var my.application.log skriver information

Tillgänglighet efter projekttyp

Projekttyp	Tillgängligt
Windows-program	Yes
Klassbibliotek	Yes
Konsolprogram	Yes
Windows-kontrollbibliotek	Yes
Webbkontrollbibliotek	No
Windows-tjänsten	Yes
Webbplats	Yes

Se även

• Exception
• TraceEventType
• Objects (Visual Basic)
• Working with Application Logs in Visual Basic
• Så här: Logga undantag i Visual Basic
• Genomgång: Fastställa var my.application.log skriver information

WriteException(Exception, TraceEventType, String)

Källa:

Log.vb

Skriver undantagsinformation till programmets logglyssnare.

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)

Parametrar

ex

Exception

Required. Undantag för loggning.

severity

TraceEventType

Typ av meddelande. Som standard . Error

additionalInfo

String

Sträng som ska läggas till i meddelandet. Som standard är detta en tom sträng.

Undantag

ArgumentNullException

ex är Nothing.

InvalidEnumArgumentException

Meddelandetypen är inte ett av uppräkningsvärdena TraceEventType .

SecurityException

Kod med partiellt förtroende anropar metoden, men skriver till en händelselogglyssnare som kräver fullständigt förtroende.

Exempel

Det här exemplet visar hur du använder My.Application.Log.WriteException metoden för att logga undantag. Avkommentering av raderna Dim och MsgBox för att orsaka ett NullReferenceException undantag. Mer information finns i Så här: Logga undantag.

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

Det här kodexemplet kan bara köras i ett klientprogram. Ändra My.Application.Log.WriteException till My.Log.WriteException för webbprogram.

Kommentarer

Metoden WriteException skriver informationen i ett undantag till programmets händelselogglyssnare.

I klientprogram är objektet Log tillgängligt via objektet My.Application.Log . I webbprogram är objektet Log tillgängligt via objektet My.Log .

Information om vilka logglyssnare WriteException som tar emot metodens meddelanden finns i Genomgång: Fastställa var my.application.log skriver information. Du kan ändra standardlogglyssnare. Mer information finns i Arbeta med programloggar.

För överlagringar som inte tar id argumentet definieras identifieraren som skrivits till loggen av följande tabell.

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

I följande tabell visas exempel på uppgifter som involverar WriteException metoden.

Till	Se
Skriv undantagsinformation till programmets händelselogglyssnare.	Anvisningar: Logga undantag
Avgör var Log skrivinformationen ska skrivas.	Genomgång: Fastställa var my.application.log skriver information

Tillgänglighet efter projekttyp

Projekttyp	Tillgängligt
Windows-program	Yes
Klassbibliotek	Yes
Konsolprogram	Yes
Windows-kontrollbibliotek	Yes
Webbkontrollbibliotek	No
Windows-tjänsten	Yes
Webbplats	Yes

Se även

• Exception
• TraceEventType
• Objects (Visual Basic)
• Working with Application Logs in Visual Basic
• Så här: Logga undantag i Visual Basic
• Genomgång: Fastställa var my.application.log skriver information

WriteException(Exception, TraceEventType, String, Int32)

Källa:

Log.vb

Skriver undantagsinformation till programmets logglyssnare.

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)

Parametrar

ex

Exception

Required. Undantag för loggning.

severity

TraceEventType

Typ av meddelande. Som standard . Error

additionalInfo

String

Sträng som ska läggas till i meddelandet. Som standard är detta en tom sträng.

id

Int32

Meddelandeidentifierare, som vanligtvis används för korrelation. Som standard gäller detta entryType enligt beskrivningen i tabellen i avsnittet Kommentarer.

Undantag

ArgumentNullException

ex är Nothing.

InvalidEnumArgumentException

Meddelandetypen är inte ett av uppräkningsvärdena TraceEventType .

SecurityException

Kod med partiellt förtroende anropar metoden, men skriver till en händelselogglyssnare som kräver fullständigt förtroende.

Exempel

Det här exemplet visar hur du använder My.Application.Log.WriteException metoden för att logga undantag. Avkommentering av raderna Dim och MsgBox för att orsaka ett NullReferenceException undantag. Mer information finns i Så här: Logga undantag.

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

Det här kodexemplet kan bara köras i ett klientprogram. Ändra My.Application.Log.WriteException till My.Log.WriteException för webbprogram.

Kommentarer

Metoden WriteException skriver informationen i ett undantag till programmets händelselogglyssnare.

I klientprogram är objektet Log tillgängligt via objektet My.Application.Log . I webbprogram är objektet Log tillgängligt via objektet My.Log .

Information om vilka logglyssnare WriteException som tar emot metodens meddelanden finns i Genomgång: Fastställa var my.application.log skriver information. Du kan ändra standardlogglyssnare. Mer information finns i Arbeta med programloggar.

För överlagringar som inte tar id argumentet definieras identifieraren som skrivits till loggen av följande tabell.

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

I följande tabell visas exempel på uppgifter som involverar WriteException metoden.

Till	Se
Skriv undantagsinformation till programmets händelselogglyssnare.	Anvisningar: Logga undantag
Avgör var Log skrivinformationen ska skrivas.	Genomgång: Fastställa var my.application.log skriver information

Tillgänglighet efter projekttyp

Projekttyp	Tillgängligt
Windows-program	Yes
Klassbibliotek	Yes
Konsolprogram	Yes
Windows-kontrollbibliotek	Yes
Webbkontrollbibliotek	No
Windows-tjänsten	Yes
Webbplats	Yes

Se även

• Exception
• TraceEventType
• Objects (Visual Basic)
• Working with Application Logs in Visual Basic
• Så här: Logga undantag i Visual Basic
• Genomgång: Fastställa var my.application.log skriver information