Metodo WriteException (My.Application.Log e My.Log)

Aggiornamento: novembre 2007

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

' Usage
My.Application.Log.WriteException(ex)
My.Application.Log.WriteException(ex ,severity ,additionalInfo)
My.Application.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Web usage
My.Log.WriteException(ex)
My.Log.WriteException(ex ,severity ,additionalInfo)
My.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Declaration
Public Sub WriteException( _
   ByVal ex As System.Exception _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String, _
   ByVal id As Integer _
)

Parametri

• ex
  Obbligatorio. Eccezione del log

• severity
  Il tipo di messaggio. Per impostazione predefinita, Error.

• additionalInfo
  Stringa da aggiungere al messaggio. Il valore predefinito è una stringa vuota.

• id
  L'identificatore dei messaggi, utilizzato in genere per la correlazione. Il valore predefinito è entryType come illustrato nella tabella della sezione Note.

Eccezioni

Un'eccezione verrà generata nelle condizioni seguenti:

• L'eccezione o il tipo di messaggio è Nothing (ArgumentNullException).

• Il tipo di messaggio non è uno dei valori di enumerazione TraceEventType (InvalidEnumArgumentException).

• Il metodo viene richiamato dal codice con attendibilità parziale che però scrive nel listener di log che richiede attendibilità completa (SecurityException).

Note

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

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

Per informazioni su quali listener di log ricevono i messaggi del metodo WriteException, vedere Procedura dettagliata: individuazione della posizione di inserimento delle informazioni con My.Application.Log. È possibile modificare i listener di log predefiniti. Per ulteriori informazioni, vedere Utilizzo dei log applicazione in Visual Basic.

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

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

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo WriteException.

Per	Vedere
Scrivere informazioni sull'eccezione nei listener del log eventi dell'applicazione.	Procedura: registrare eccezioni in Visual Basic
Determinare la posizione dove Log scrive le informazioni.	Procedura dettagliata: individuazione della posizione di inserimento delle informazioni con My.Application.Log

Esempio

Nell'esempio seguente viene illustrato come utilizzare il metodo My.Application.Log.WriteException per registrare le eccezioni. Rimuovere il commento dalle righe Dim e MsgBox per indurre un'eccezione NullReferenceException. Per ulteriori informazioni, vedere Procedura: registrare eccezioni in Visual Basic.

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

L'esecuzione di questo esempio di codice può avvenire solo all'interno di un'applicazione client. Cambiare My.Application.Log.WriteException in My.Log.WriteException per le applicazioni Web.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.Logging

Classe:Log

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilità per 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ì

Autorizzazioni

Potrebbe essere necessaria la seguente autorizzazione:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Attività

Procedura: registrare eccezioni in Visual Basic

Procedura dettagliata: individuazione della posizione di inserimento delle informazioni con My.Application.Log

Concetti

Utilizzo dei log applicazione in Visual Basic

Riferimenti

Oggetto My.Application.Log

Oggetto My.Log

System.Exception

System.Diagnostics.TraceEventType

Log.WriteException