Log.WriteException Metod

Definition

Namnområde:
Microsoft.VisualBasic.Logging
Sammansättning:
Microsoft.VisualBasic.dll
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
Källa:
Log.vb
Källa:
Log.vb
Källa:
Log.vb
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

Gäller för

WriteException(Exception, TraceEventType, String)

Källa:
Log.vb
Källa:
Log.vb
Källa:
Log.vb
Källa:
Log.vb
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

Gäller för

WriteException(Exception, TraceEventType, String, Int32)

Källa:
Log.vb
Källa:
Log.vb
Källa:
Log.vb
Källa:
Log.vb
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

Gäller för