Esempio di registrazione eventi
Aggiornamento: novembre 2007
In questo esempio viene illustrato come utilizzare e configurare l'oggetto My.Application.Log.
In Visual Basic sono disponibili due meccanismi di registrazione eventi diversi. My.Application.Log fornisce l'accesso ai log eventi del sistema operativo e inoltre consente di scrivere messaggi in file di testo. Il componente EventLog fornisce l'accesso ai log eventi del sistema operativo. Il componente EventLog consente di aggiungere ed eliminare log, aggiungere e rimuovere origini dei log eventi, scrivere messaggi ed eliminare messaggi. Per un esempio di codice, vedere Esempio di log eventi.
Per ottenere esempi e istruzioni per la relativa installazione
Effettuare una delle seguenti operazioni:
Dal menu Guida, scegliere Esempi.
Il file Readme contiene informazioni sugli esempi.
Visitare il sito Web Visual Studio 2008 Samples (informazioni in lingua inglese). Su tale sito sono disponibili le versioni più recenti degli esempi.
Individuare gli esempi sul computer in cui è installato Visual Studio. Il percorso di installazione predefinito degli esempi e del file Readme relativo è unità:\Programmi\Microsoft Visual Studio 9.0\Samples\lcid. Per le versioni Express di Visual Studio tutti gli esempi sono disponibili in linea.
Per ulteriori informazioni, vedere Individuazione dei file di esempio.
.gif "Nota sulla sicurezza") Nota sulla sicurezza: |
|---|
In questo esempio di codice viene illustrato un concetto e viene presentato solo il codice rilevante. È possibile che questo esempio non soddisfi i requisiti di sicurezza per un ambiente specifico ed è opportuno non utilizzarlo così come viene riportato. È consigliabile aggiungere codice relativo alla sicurezza e alla gestione degli errori per rendere i progetti più sicuri e potenti. Microsoft fornisce questo esempio di codice "COSÌ COM'È" senza garanzie. |
Per eseguire l'esempio
Premere F5. Nel form principale sono elencati i listener configurati per l'esempio.
Scrivere un messaggio nel controllo TextBox del form.
Fare clic sul pulsante Write Log Message.
Il messaggio viene scritto per ogni listener.
Il file XML scritto dall'oggetto XmlWriterTraceListener si trova in c:\logsamples\SampleLog.xml.
Il file di testo normale scritto dall'oggetto FileLogTraceListener si trova nella directory "Dati applicazioni". Se si esegue il programma in Visual Studio, il percorso sarà analogo a "c:\Documents And Settings\[utente]\Dati applicazioni\Microsoft Corporation\Microsoft Visual Studio\[8.0*]\LogSample.log.
Dimostrazione
Contenuto dell'esempio:
Form1 Fornisce un semplice form che contiene l'elenco di tutti i listener attualmente attivati per My.Application.Log e i controlli che consentono di scrivere il testo in My.Application.Log.
app.config Definisce la configurazione di My.Application.Log, vale a dire dove devono essere scritti i messaggi, quali messaggi devono essere filtrati e così via.
In questo esempio viene illustrato come utilizzare My.Application.Log per scrivere un file di testo normale, il log eventi e un file XML. È possibile implementare un oggetto TraceListener personalizzato che scriva anche in altre posizioni, ad esempio in un database o in un messaggio di posta elettronica.
A ogni messaggio viene assegnato il livello di gravità selezionato nel form. Quando riceve il messaggio, il listener può eliminarlo in base al livello di filtro. Il componente EventLogTraceListener, ad esempio, è configurato in modo da scrivere solo messaggi di errore, quindi tutti i messaggi scritti con livello di gravità "Informazioni" o "Avviso" verranno scritti nel file XML e nel file di testo normale, ma non nell'oggetto EventLog.
Per modificare il comportamento dell'esempio, modificare il file app.config del progetto. Per modificare il file, seguire i commenti presenti nel file.
È possibile utilizzare My.Application.Log e il modello dell'applicazione per registrare le eccezioni relative all'avvio e all'arresto, nonché le eccezioni non gestite. Per visualizzare il codice dell'esempio, fare doppio clic su Progetto in Esplora soluzioni. Nel riquadro Applicazione fare clic sul pulsante Visualizza codice.