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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Prima che il componente sia in grado di scrivere voci in un log eventi, è necessario registrarlo come origine eventi valida. A tale scopo, utilizzare il metodo CreateEventSource e specificare una stringa che identifichi in modo univoco il componente nel log eventi. Quando si scrive una voce, viene utilizzata l'origine precedentemente specificata per trovare il log appropriato in cui inserire la voce. L'istanza del componente EventLog esegue la scrittura in un solo log alla volta.

Nota:
Per impostazione predefinita, se si tenta di scrivere una voce senza aver prima registrato il componente come origine valida, l'origine viene registrata automaticamente con il log eventi, utilizzando il valore della proprietà Source come stringa di origine. In generale, è opportuno creare la nuova origine eventi durante l'installazione dell'applicazione. In questo modo, al sistema operativo viene concesso il tempo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se si tenta di scrivere un evento con la nuova origine quando l'elenco di origini eventi del sistema operativo non è stato aggiornato, l'operazione di scrittura avrà esito negativo. Se non è possibile creare l'origine durante l'installazione, provare a crearla prima dell'esecuzione della prima operazione di scrittura, ad esempio durante l'inizializzazione dell'applicazione. In questo caso, assicurarsi che il codice di inizializzazione sia in esecuzione con i diritti di amministratore sul computer, necessari per la creazione di nuove origini eventi.

Per impostazione predefinita, se si tenta di scrivere una voce senza aver prima registrato il componente come origine valida, l'origine viene registrata automaticamente con il log eventi, utilizzando il valore della proprietà Source come stringa di origine. In generale, è opportuno creare la nuova origine eventi durante l'installazione dell'applicazione. In questo modo, al sistema operativo viene concesso il tempo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se si tenta di scrivere un evento con la nuova origine quando l'elenco di origini eventi del sistema operativo non è stato aggiornato, l'operazione di scrittura avrà esito negativo. Se non è possibile creare l'origine durante l'installazione, provare a crearla prima dell'esecuzione della prima operazione di scrittura, ad esempio durante l'inizializzazione dell'applicazione. In questo caso, assicurarsi che il codice di inizializzazione sia in esecuzione con i diritti di amministratore sul computer, necessari per la creazione di nuove origini eventi.

Se si specifica il nome di un log non esistente quando si usa il metodo CreateEventSource, verrà creato un nuovo log eventi personalizzato con il nome specificato la prima volta che si tenta di scrivere una voce nel log. Per ulteriori informazioni, vedere Procedura: creare e rimuovere log eventi personalizzati.

È possibile registrare l'origine eventi con le risorse localizzate per la categoria di eventi e le stringhe di messaggio. Le voci dei log eventi possono essere scritte nell'applicazione in uso tramite gli identificatori di risorsa, anziché tramite la specifica di valori stringa effettivi. Per ulteriori informazioni sulla configurazione dell'origine con i file di risorse, fare riferimento alle classi EventLogInstaller e EventSourceCreationData.

Per definire il componente come origine eventi

Per creare voci nel computer locale, chiamare il metodo CreateEventSource e specificare la stringa di origine e il nome del log come parametri.

Nota:

Se si specifica un valore Null (" ") per il nome del log, verrà utilizzata l'impostazione predefinita Application.

Nell'esempio riportato di seguito viene illustrato come registrare il componente MyApp1 come origine per il log Application. Nel codice si presuppone che esista un'istruzione Imports o using per lo spazio dei nomi System.Diagnostics:
```
EventLog.CreateEventSource("MyApp1", "Application")
```
```
     System.Diagnostics.EventLog.CreateEventSource("MyApp1", "Application");
```
Suggerimento:

Per creare un'origine eventi in un computer remoto, utilizzare la classe EventSourceCreationData. Il codice che segue fornisce un esempio in proposito.
```
Dim creationData As New EventSourceCreationData("ApplicationName", "Application")
creationData.MachineName = "ServerName"
EventLog.CreateEventSource(creationData)
```
```
     System.Diagnostics.EventSourceCreationData creationData = new
            System.Diagnostics.EventSourceCreationData("ApplicationName", "Application");
        creationData.MachineName = "ServerName";
        EventLog.CreateEventSource(creationData);
```

Nota:
Se si specifica un valore Null (" ") per il nome del log, verrà utilizzata l'impostazione predefinita Application.

Suggerimento:
Per creare un'origine eventi in un computer remoto, utilizzare la classe EventSourceCreationData. Il codice che segue fornisce un esempio in proposito.

Vedere anche

Condividi tramite

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

Per definire il componente come origine eventi

Vedere anche

Attività

Concetti

Riferimenti

Risorse aggiuntive