Architettura di programmazione di EventLog
Aggiornamento: novembre 2007
Il componente EventLog usa le parti degli spazi dei nomi di .NET Framework indicate di seguito.
Spazio dei nomi EventLog
.gif)
Quando si aggiunge un'istanza del componente EventLog all'applicazione in Visual Studio, vengono creati automaticamente i riferimenti e le istruzioni di importazione necessari per l'accesso allo spazio dei nomi e alle classi. Se invece si stanno creando componenti EventLog nel codice o in Microsoft .NET Framework, potrebbe essere necessario creare un riferimento allo spazio dei nomi System.Diagnostics e aggiungere un'istruzione al progetto per l'importazione della stessa libreria.
Per informazioni sull'aggiunta e sulla rimozione dei riferimenti al progetto, vedere Procedura: aggiungere o rimuovere riferimenti in Visual Studio (Visual Basic).
Principali elementi di programmazione della classe EventLog
Il componente EventLog genera un evento EntryWritten ogni volta che viene scritta una voce nel log in uso. Per questo evento è possibile definire un gestore. Per interagire con un'istanza del componente EventLog è inoltre possibile utilizzare i seguenti metodi:
Il metodo Exists consente di determinare l'esistenza di un log eventi specifico.
Il metodo CreateEventSource consente di definire una stringa per la creazione di una relazione tra un'origine eventi e un log, mentre il metodo DeleteEventSource consente di rimuovere tale associazione. È possibile utilizzare questo metodo anche per creare nuovi log eventi personalizzati. È sufficiente immettere il nome del nuovo log in cui si desidera creare l'origine affinché il log venga generato automaticamente.
.gif "Nota")
Nota:È possibile impostare la proprietà Source su qualsiasi stringa: non è necessario che corrisponda al nome dell'applicazione in uso. Un'applicazione può includere più componenti che utilizzano diverse stringhe di origine per l'identificazione nei log eventi.
Il metodo WriteEntry consente di scrivere informazioni sugli eventi in un log eventi a cui si ha accesso. Il metodo WriteEntry registra automaticamente il componente o l'applicazione come origine valida se non è stata ancora eseguita la registrazione nel log designato.
Il metodo SourceExists consente di determinare se una determinata origine è già registrata. Ciò risulta utile quando si tenta di creare una nuova origine in un computer specifico, poiché il metodo SourceExists genera un errore di runtime se l'origine è già stata registrata nel computer in questione.
Il metodo GetEventLogs consente di recuperare un elenco di tutti i log eventi presenti in un determinato computer.
Il metodo Delete consente di eliminare un intero log eventi. Si consiglia di utilizzare questo metodo con attenzione poiché con l'eliminazione di un log verranno rimosse anche le origini registrate.