Log.WriteException Metodo

Definizione

Spazio dei nomi:: Microsoft.VisualBasic.Logging

Assembly:: Microsoft.VisualBasic.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scrive le informazioni sulle eccezioni nei listener di log dell'applicazione.

Overload

Nome	Descrizione
WriteException(Exception)	Scrive le informazioni sulle eccezioni nei listener di log dell'applicazione.
WriteException(Exception, TraceEventType, String)	Scrive le informazioni sulle eccezioni nei listener di log dell'applicazione.
WriteException(Exception, TraceEventType, String, Int32)	Scrive le informazioni sulle eccezioni nei listener di log dell'applicazione.

WriteException(Exception)

Scrive le informazioni sulle eccezioni nei listener di 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

Required. Eccezione per la registrazione.

Eccezioni

ArgumentNullException

ex è Nothing.

SecurityException

Il codice con attendibilità parziale chiama il metodo , ma scrive in un listener del log eventi che richiede l'attendibilità totale.

Esempio

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

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

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 nei listener del registro 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 della posizione in cui my.application.log scrive informazioni. È possibile modificare i listener di log predefiniti. Per altre informazioni, vedere Uso dei log applicazioni.

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

`severity`	Valore 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 .

Per	Vedi
Scrivere informazioni sulle eccezioni nei listener del registro eventi dell'applicazione.	Procedura: Registrare le eccezioni
Determinare dove `Log` scrive le informazioni.	Procedura dettagliata: determinazione della posizione in cui my.application.log scrive le informazioni

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Yes
Biblioteca di classi	Yes
Applicazione console	Yes
Libreria di controlli Windows	Yes
Libreria di controlli Web	No
Servizio Windows	Yes
Sito web	Yes

Vedi anche

Si applica a

WriteException(Exception, TraceEventType, String)

Scrive le informazioni sulle eccezioni nei listener di 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

Required. Eccezione per la registrazione.

severity: TraceEventType

Il tipo di messaggio. Per impostazione predefinita, Error.

additionalInfo: String

Stringa da aggiungere al messaggio. Per impostazione predefinita, si tratta di una stringa vuota.

Eccezioni

ArgumentNullException

ex è Nothing.

InvalidEnumArgumentException

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

SecurityException

Il codice con attendibilità parziale chiama il metodo , ma scrive in un listener del log eventi che richiede l'attendibilità totale.

Esempio

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

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 nei listener del registro 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 gli overload che non accettano l'argomento , l'identificatore id scritto nel log è definito dalla tabella seguente.

`severity`	Valore 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 .

Per	Vedi
Scrivere informazioni sulle eccezioni nei listener del registro eventi dell'applicazione.	Procedura: Registrare le eccezioni
Determinare dove `Log` scrive le informazioni.	Procedura dettagliata: determinazione della posizione in cui my.application.log scrive le informazioni

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Yes
Biblioteca di classi	Yes
Applicazione console	Yes
Libreria di controlli Windows	Yes
Libreria di controlli Web	No
Servizio Windows	Yes
Sito web	Yes

Vedi anche

Si applica a

WriteException(Exception, TraceEventType, String, Int32)

Scrive le informazioni sulle eccezioni nei listener di 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

Required. Eccezione per la registrazione.

severity: TraceEventType

Il tipo di messaggio. Per impostazione predefinita, Error.

additionalInfo: String

Stringa da aggiungere al messaggio. Per impostazione predefinita, si tratta di una stringa vuota.

id: Int32

Identificatore del messaggio, in genere usato per la correlazione. Per impostazione predefinita, correlato a entryType come descritto nella tabella nella sezione Osservazioni.

Eccezioni

ArgumentNullException

ex è Nothing.

InvalidEnumArgumentException

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

SecurityException

Il codice con attendibilità parziale chiama il metodo , ma scrive in un listener del log eventi che richiede l'attendibilità totale.

Esempio

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

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 nei listener del registro 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 gli overload che non accettano l'argomento , l'identificatore id scritto nel log è definito dalla tabella seguente.

`severity`	Valore 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 .

Per	Vedi
Scrivere informazioni sulle eccezioni nei listener del registro eventi dell'applicazione.	Procedura: Registrare le eccezioni
Determinare dove `Log` scrive le informazioni.	Procedura dettagliata: determinazione della posizione in cui my.application.log scrive le informazioni

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Yes
Biblioteca di classi	Yes
Applicazione console	Yes
Libreria di controlli Windows	Yes
Libreria di controlli Web	No
Servizio Windows	Yes
Sito web	Yes

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?