Log.WriteException Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

Scrive le informazioni sull'eccezione nei listener del log dell'applicazione

Overload

WriteException(Exception)	Scrive le informazioni sull'eccezione nei listener del log dell'applicazione
WriteException(Exception, TraceEventType, String)	Scrive le informazioni sull'eccezione nei listener del log dell'applicazione
WriteException(Exception, TraceEventType, String, Int32)	Scrive le informazioni sull'eccezione nei listener del log dell'applicazione

WriteException(Exception)

Scrive le informazioni sull'eccezione nei listener del log dell'applicazione

public:
 void WriteException(Exception ^ ex);

public void WriteException (Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

Parametri

ex

Exception

Obbligatorio. Eccezione da registrare.

Eccezioni

ArgumentNullException

ex è Nothing.

SecurityException

Il metodo viene chiamato dal codice con attendibilità parziale che tuttavia consente di scrivere nel listener del registro eventi che richiede attendibilità totale.

Esempio

In questo esempio viene illustrato come usare il My.Application.Log.WriteException metodo per registrare le eccezioni. Rimuovere il commento dalle righe Dim e MsgBox per causare un'eccezione NullReferenceException. Per altre informazioni, vedere Procedura: Eccezioni di log.

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

Questo esempio di codice può essere eseguito solo all'interno di un'applicazione client. Passare My.Application.Log.WriteException a My.Log.WriteException per le applicazioni Web.

Commenti

Il WriteException metodo scrive le informazioni contenute in un'eccezione ai listener del log eventi dell'applicazione.

Nelle applicazioni client l'oggetto Log è disponibile tramite l'oggetto My.Application.Log . Nelle applicazioni Web l'oggetto Log è disponibile tramite l'oggetto My.Log .

Per informazioni sui listener di log che ricevono i WriteException messaggi del metodo, vedere Procedura dettagliata: Determinazione delle informazioni sulle scritture di My.Application.Log. È possibile modificare i listener di log predefiniti. Per altre informazioni, vedere Uso dei log applicazione.

Per gli overload che non accettano l'argomento, l'identificatore id scritto nel log è definito dalla tabella seguente.

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

Nella tabella seguente sono elencati esempi di attività che coinvolgono il WriteException metodo.

A	Vedere
Scrivere informazioni sull'eccezione nei listener del log eventi dell'applicazione.	Procedura: Registrare eccezioni
Determinare la posizione in cui Log scrive le informazioni.	Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	No
Servizio Windows	Sì
Sito Web	Sì

Vedi anche

• Exception
• TraceEventType
• Oggetti (Visual Basic)
• Utilizzo dei log applicazione in Visual Basic
• Procedura: registrare eccezioni in Visual Basic
• Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

WriteException(Exception, TraceEventType, String)

Scrive le informazioni sull'eccezione nei listener del log dell'applicazione

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)

Parametri

ex

Exception

Obbligatorio. Eccezione da registrare.

severity

TraceEventType

Tipo di messaggio. Per impostazione predefinita, Error.

additionalInfo

String

Stringa da aggiungere al messaggio. Per impostazione predefinita, questa è una stringa vuota.

Eccezioni

ArgumentNullException

ex è Nothing.

InvalidEnumArgumentException

Il tipo di messaggio non è uno dei valori di enumerazione TraceEventType.

SecurityException

Il metodo viene chiamato dal codice con attendibilità parziale che tuttavia consente di scrivere nel listener del registro eventi che richiede attendibilità totale.

Esempio

In questo esempio viene illustrato come usare il My.Application.Log.WriteException metodo per registrare le eccezioni. Rimuovere il commento dalle righe Dim e MsgBox per causare un'eccezione NullReferenceException. Per altre informazioni, vedere Procedura: Eccezioni di log.

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

Questo esempio di codice può essere eseguito solo all'interno di un'applicazione client. Passare My.Application.Log.WriteException a My.Log.WriteException per le applicazioni Web.

Commenti

Il WriteException metodo scrive le informazioni contenute in un'eccezione ai listener del log eventi dell'applicazione.

Nelle applicazioni client l'oggetto Log è disponibile tramite l'oggetto My.Application.Log . Nelle applicazioni Web l'oggetto Log è disponibile tramite l'oggetto My.Log .

Per informazioni sui listener di log che ricevono i WriteException messaggi del metodo, vedere Procedura dettagliata: Determinazione delle informazioni sulle scritture di My.Application.Log. È possibile modificare i listener di log predefiniti. Per altre informazioni, vedere Uso dei log applicazione.

Per gli overload che non accettano l'argomento, l'identificatore id scritto nel log è definito dalla tabella seguente.

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

Nella tabella seguente sono elencati esempi di attività che coinvolgono il WriteException metodo.

A	Vedere
Scrivere informazioni sull'eccezione nei listener del log eventi dell'applicazione.	Procedura: Registrare eccezioni
Determinare la posizione in cui Log scrive le informazioni.	Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	No
Servizio Windows	Sì
Sito Web	Sì

Vedi anche

• Exception
• TraceEventType
• Oggetti (Visual Basic)
• Utilizzo dei log applicazione in Visual Basic
• Procedura: registrare eccezioni in Visual Basic
• Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

WriteException(Exception, TraceEventType, String, Int32)

Scrive le informazioni sull'eccezione nei listener del log dell'applicazione

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)

Parametri

ex

Exception

Obbligatorio. Eccezione da registrare.

severity

TraceEventType

Tipo di messaggio. Per impostazione predefinita, Error.

additionalInfo

String

Stringa da aggiungere al messaggio. Per impostazione predefinita, questa è una stringa vuota.

id

Int32

Identificatore di messaggio, solitamente utilizzato per la correlazione. Per impostazione predefinita, correlata a entryType come descritto nella tabella nella sezione Osservazioni.

Eccezioni

ArgumentNullException

ex è Nothing.

InvalidEnumArgumentException

Il tipo di messaggio non è uno dei valori di enumerazione TraceEventType.

SecurityException

Il metodo viene chiamato dal codice con attendibilità parziale che tuttavia consente di scrivere nel listener del registro eventi che richiede attendibilità totale.

Esempio

In questo esempio viene illustrato come usare il My.Application.Log.WriteException metodo per registrare le eccezioni. Rimuovere il commento dalle righe Dim e MsgBox per causare un'eccezione NullReferenceException. Per altre informazioni, vedere Procedura: Eccezioni di log.

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

Questo esempio di codice può essere eseguito solo all'interno di un'applicazione client. Passare My.Application.Log.WriteException a My.Log.WriteException per le applicazioni Web.

Commenti

Il WriteException metodo scrive le informazioni contenute in un'eccezione ai listener del log eventi dell'applicazione.

Nelle applicazioni client l'oggetto Log è disponibile tramite l'oggetto My.Application.Log . Nelle applicazioni Web l'oggetto Log è disponibile tramite l'oggetto My.Log .

Per informazioni sui listener di log che ricevono i WriteException messaggi del metodo, vedere Procedura dettagliata: Determinazione delle informazioni sulle scritture di My.Application.Log. È possibile modificare i listener di log predefiniti. Per altre informazioni, vedere Uso dei log applicazione.

Per gli overload che non accettano l'argomento, l'identificatore id scritto nel log è definito dalla tabella seguente.

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

Nella tabella seguente sono elencati esempi di attività che coinvolgono il WriteException metodo.

A	Vedere
Scrivere informazioni sull'eccezione nei listener del log eventi dell'applicazione.	Procedura: Registrare eccezioni
Determinare la posizione in cui Log scrive le informazioni.	Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	No
Servizio Windows	Sì
Sito Web	Sì

Vedi anche

• Exception
• TraceEventType
• Oggetti (Visual Basic)
• Utilizzo dei log applicazione in Visual Basic
• Procedura: registrare eccezioni in Visual Basic
• Procedura dettagliata: Individuazione della posizione di inserimento delle informazioni con My.Application.Log