Procedura: configurare istanze del componente EventLog

Articolo
09/12/2008

Aggiornamento: novembre 2007

Nella configurazione di un'istanza del componente EventLog vengono utilizzate tre proprietà principali:

La proprietà Log indica il log con cui si desidera interagire.
La proprietà MachineName indica il computer in cui si trova il log in uso.
La proprietà Source indica la stringa di origine che verrà utilizzata per identificare il componente durante la scrittura di voci in un log.

La modalità di configurazione delle istanze del componente EventLog dipende dall'utilizzo previsto.

Se si intende scrivere voci in un log, è necessario effettuare una delle due seguenti operazioni: È necessario registrare un'origine utilizzando il metodo CreateEventSource e impostare la proprietà Source del componente EventLog su tale origine oppure impostare le proprietà MachineName, Log e Source del componente.

Nota:
È possibile impostare la proprietà Log direttamente nel componente oppure nel codice per la registrazione del componente come origine eventi. Una volta registrato il componente come origine, viene impostata una connessione nel Registro di sistema del server che collega il componente a un log specifico.

Se si intende leggere le voci o monitorare un log, è necessario impostare le proprietà MachineName e Log in modo da indicare il log da controllare. In questo caso, non è necessario impostare la proprietà Source.
Se si desidera che il componente sia in grado di ricevere la notifica degli eventi EntryWritten, è necessario impostare la proprietà EnableRaisingEvents su true. Per ulteriori informazioni, vedere Procedura: gestire l'evento EntryWritten.

Nell'esempio che segue è illustrato come configurare il componente in modo da consentire la scrittura di voci nel log Application. In questo caso, l'origine non è stata ancora registrata con il log ed è pertanto necessario specificare la stringa di origine, il log e il nome del computer. Non è necessario chiamare in modo esplicito il metodo CreateEventSource poiché l'origine verrà registrata mediante la chiamata al metodo WriteEntry, se il log non è stato ancora registrato.
```
Dim EventLog1 As New EventLog("Application", "myserver", "newsource")
EventLog1.WriteEntry("Test")
```
```
     System.Diagnostics.EventLog EventLog1 = new
           System.Diagnostics.EventLog("Application", "myserver", "newsource");
        EventLog1.WriteEntry("Test");
```
Se l'origine è già stata registrata, è possibile impostare solo la proprietà Source e scrivere la voce. Il codice seguente, ad esempio, indica come scrivere una voce in un log mediante un'origine già registrata,
```
If Not EventLog.SourceExists("ExistingSourceString") Then
    EventLog.CreateEventSource("ExistingSourceString", "Application")
End If
Dim EventLog1 As New EventLog()
EventLog1.Source = "ExistingSourceString"
EventLog1.WriteEntry("TestEntry2")
```
```
     if (!System.Diagnostics.EventLog.SourceExists("ExistingSourceString"))
            System.Diagnostics.EventLog.CreateEventSource(
               "ExistingSourceString", "Application");

        System.Diagnostics.EventLog EventLog1 =
           new System.Diagnostics.EventLog();
        EventLog1.Source = "ExistingSourceString";
        EventLog1.WriteEntry("TestEntry2");
```
Nota:

Se non si imposta la proprietà MachineName, così come indicato negli esempi sopra riportati, verrà utilizzato il nome del computer locale.

Per ulteriori informazioni su tali proprietà, vedere Riferimenti al log eventi.

Le voci recuperate dai log eventi vengono suddivise in categorie in base alle proprietà. Per informazioni su tali proprietà, vedere EventLog.

Nota:
Se non si imposta la proprietà MachineName, così come indicato negli esempi sopra riportati, verrà utilizzato il nome del computer locale.

Per configurare un'istanza del componente EventLog

Creare un'istanza del componente EventLog. Per ulteriori informazioni, vedere Procedura: creare istanze del componente EventLog.

Impostare la combinazione appropriata delle proprietà Log, MachineName e Source:

Per	Effettuare quanto segue
Leggere o monitorare log eventi	Impostare le proprietà Log e MachineName.
Scrivere voci in un log mediante una nuova stringa Source	Impostare le proprietà Source, Log e MachineName.
Scrivere voci in un log per una proprietà Source esistente	Impostare la proprietà Source sull'origine esistente; le altre proprietà verranno impostate automaticamente.

Per abilitare la ricezione di notifiche dell'evento EntryWritten da parte dell'istanza del componente, impostare la proprietà EnableRaisingEvents su true.

Vedere anche

Attività

Procedura: creare istanze del componente EventLog

Procedura: aggiungere l'applicazione come origine delle voci del log eventi

Procedura: scrivere voci nei log eventi

Concetti

Riferimenti al log eventi

Condividi tramite

Procedura: configurare istanze del componente EventLog

Per configurare un'istanza del componente EventLog

Vedere anche

Attività

Concetti

Risorse aggiuntive