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

Aggiornamento: novembre 2007

Consente di scrivere un messaggio sui listener di log dell'applicazione.

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

Parametri

• message
  Obbligatorio. Il messaggio da registrare. Se message è Nothing, viene utilizzata una stringa vuota.

• severity
  Il tipo di messaggio. Per impostazione predefinita, TraceEventType.Information.

• id
  L'identificatore dei messaggi, utilizzato in genere per la correlazione. Per impostazione predefinita, correlato a entryType secondo la descrizione nella tabella.

Eccezioni

Le condizioni elencate di seguito causano un'eccezione:

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

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

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

Note

Con il metodo WriteEntry è possibile scrivere un messaggio nei listener di 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 WriteEntry, 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'id scritto nel log viene definito dalla 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 WriteEntry.

Per	Vedere
Scrivere informazioni sugli eventi nei listener di log dell'applicazione	Procedura: scrivere messaggi di log
Determinare dove Log scrive le informazioni	Procedura dettagliata: individuazione della posizione di inserimento delle informazioni con My.Application.Log

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare il metodo My.Application.Log.WriteEntry per registrare informazioni di analisi. Per ulteriori informazioni, vedere Procedura: scrivere messaggi di log.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( _
        "Entering TracingTest with argument " & _
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( _
        "Exiting TracingTest with argument " & _
        fileName & ".")
End Sub

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

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.Logging

Classe:Log

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

Disponibilità in base al tipo di progetto

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

Autorizzazioni

Potrebbe essere necessaria l'autorizzazione riportata di seguito:

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: scrivere messaggi di log

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.Diagnostics.TraceEventType

Log.WriteEntry