EventLog Classe

Definizione

public ref class EventLog : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class EventLog : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type EventLog = class
    inherit Component
    interface ISupportInitialize

Public Class EventLog
Inherits Component
Implements ISupportInitialize

Ereditarietà

Object

MarshalByRefObject

Component

EventLog

Implementazioni

ISupportInitialize

Esempio

Nell'esempio seguente viene creata l'origine MySource evento se non esiste già e scrive una voce nel registro MyNewLogeventi .

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      //An event log source should not be created and immediately used.
      //There is a latency time to enable the source, it should be created
      //prior to executing the application that uses the source.
      //Execute this sample a second time to use the new source.
      EventLog::CreateEventSource( "MySource", "MyNewLog" );
      Console::WriteLine( "CreatingEventSource" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Commenti

EventLog consente di accedere o personalizzare i log eventi di Windows, che registrano informazioni su eventi software o hardware importanti. Usando EventLog, è possibile leggere dai log esistenti, scrivere voci nei log, creare o eliminare origini eventi, eliminare i log e rispondere alle voci di log. È anche possibile creare nuovi log durante la creazione di un'origine evento.

Oltre a fornire l'accesso ai singoli log eventi e alle relative voci, la EventLog classe consente di accedere alla raccolta di tutti i log eventi. È possibile usare i static membri di EventLog per eliminare i log, ottenere elenchi di log, creare o eliminare un'origine o determinare se un computer contiene già un'origine specifica.

Sono disponibili tre log eventi predefiniti: applicazione, sistema e sicurezza. Un log di sicurezza è di sola lettura. Altre applicazioni e servizi installati, ad esempio Active Directory, potrebbero avere log eventi aggiuntivi.

Esistono considerazioni sulla sicurezza quando si usa la EventLog classe. EventLog richiede EventLogPermission autorizzazioni per azioni specifiche in .NET Framework 2.0 e versioni successive o attendibilità completa in .NET Framework 1.0 e 1.1. È consigliabile EventLogPermission non essere concesso al codice parzialmente attendibile. Non è mai necessario passare alcun oggetto del log eventi, inclusi EventLogEntryCollection e EventLogEntry oggetti, a codice meno attendibile. Ad esempio, la creazione di un oggetto, la scrittura di una voce e il passaggio dell'oggetto al codice parzialmente attendibile può creare un EventLog problema di sicurezza, perché la possibilità di leggere e scrivere nel registro eventi consente al codice di eseguire azioni come l'emissione EventLog di messaggi del registro eventi nel nome di un'altra applicazione.

A partire da Windows Vista, Controllo account utente determina le credenziali di un utente. Ai membri del gruppo Administrators predefinito vengono assegnati due token di accesso in fase di esecuzione, ovvero un token di accesso utente standard e un token di accesso amministratore. Per impostazione predefinita, viene assegnato il ruolo dell'utente standard. Per eseguire il codice che accede al log di sicurezza, è prima necessario elevare le credenziali dall'utente standard all'amministratore. È possibile eseguire questa operazione quando si avvia un'applicazione aprendo il menu di scelta rapida per l'applicazione (se si usa un mouse, fare clic con il pulsante destro del mouse sull'icona dell'applicazione) e indicando che si vuole eseguire come amministratore.

È possibile usare EventLog per creare log eventi personalizzati che è possibile visualizzare tramite il Visualizzatore eventi del server. Usare il RegisterDisplayName metodo per visualizzare un nome localizzato per il registro eventi nel Visualizzatore eventi. Usare il metodo per configurare il ModifyOverflowPolicy comportamento del registro eventi quando raggiunge le dimensioni massime del log.

Per leggere da un registro eventi, specificare il nome del log (proprietà) e il nome del computer server (LogMachineName proprietà per il registro eventi. Se non si specifica il nome del computer server, si presuppone che il computer locale, ".". Non è necessario specificare l'origine evento (Source proprietà), perché è necessaria un'origine solo per la scrittura nei log. La Entries proprietà viene popolata automaticamente con l'elenco di voci del registro eventi.

Per scrivere in un registro eventi, specificare o creare un'origine evento (Source proprietà). È necessario disporre di credenziali amministrative nel computer per creare una nuova origine evento. L'origine eventi registra l'applicazione con il registro eventi come origine valida delle voci. È possibile usare l'origine evento per scrivere in un solo log alla volta. La Source proprietà può essere qualsiasi stringa casuale, ma il nome deve essere distinto da altre origini nel computer. L'origine evento è in genere il nome dell'applicazione o un'altra stringa di identificazione. Il tentativo di creare un valore duplicato Source genera un'eccezione. Tuttavia, un singolo registro eventi può essere associato a più origini.

Se l'origine evento per il log eventi associato all'istanza EventLog non esiste, viene creata una nuova origine evento. Per creare un'origine evento in Windows Vista e versioni successive o Windows Server 2003, è necessario disporre delle credenziali amministrative.

Questo requisito è dovuto al fatto che tutti i log eventi, inclusi i log di sicurezza, devono essere cercati per determinare se l'origine evento è univoca. A partire da Windows Vista, gli utenti non dispongono dell'autorizzazione per accedere al log di sicurezza; pertanto, viene generata un'eccezione SecurityException .

Le applicazioni e i servizi devono scrivere nel log dell'applicazione o in un log personalizzato. I driver di dispositivo devono scrivere nel log di sistema. Se la proprietà non viene impostata Log in modo esplicito, il registro eventi viene predefinito nel log applicazioni.

Usare i WriteEvent metodi e WriteEntry per scrivere eventi in un registro eventi. È necessario specificare un'origine evento per scrivere eventi; è necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.

Create la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e la relativa configurazione. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstaller oggetto o il CreateEventSource metodo . È necessario disporre di credenziali amministrative nel computer per creare una nuova origine evento.

Ogni origine può scrivere in un solo log eventi alla volta; Tuttavia, l'applicazione può usare più origini per scrivere in più log eventi. Ad esempio, l'applicazione potrebbe richiedere più origini configurate per registri eventi diversi o file di risorse diversi. Per modificare i dettagli di configurazione di un'origine esistente, è necessario eliminare l'origine e quindi crearla con la nuova configurazione. Se altre applicazioni o componenti usano l'origine esistente, creare una nuova origine con la configurazione aggiornata anziché eliminare l'origine esistente.

È possibile registrare l'origine eventi con risorse localizzate per la categoria di eventi e le stringhe di messaggio. L'applicazione può scrivere voci del registro eventi usando identificatori di risorsa anziché specificare i valori di stringa effettivi. Per altre informazioni sulla configurazione dell'origine con i file di risorse, vedere le EventLogInstaller classi e EventSourceCreationData .

Se l'applicazione scrive i valori stringa direttamente nel registro eventi, non è necessario impostare le proprietà del file di risorse per l'origine. L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Se l'applicazione scrive voci con identificatori di risorsa e valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine WriteEvent con i file di risorse e quindi usare tale origine nel metodo per scrivere voci usando identificatori di risorsa nel registro eventi. Creare quindi un'origine diversa senza file di risorse e usare tale origine nel metodo per scrivere stringhe direttamente nel WriteEntry registro eventi usando tale origine.

Quando si scrivono eventi, è necessario specificare almeno una stringa di messaggio o l'identificatore di risorsa per una stringa di messaggio. Altre proprietà dell'evento sono facoltative. Esempi di impostazioni di evento facoltative includono quanto segue:

• È possibile impostare l'oggetto EventLogEntryType per specificare l'icona visualizzata dall'Visualizzatore eventi per la voce.

• È possibile specificare un identificatore di categoria per l'evento, se l'applicazione usa categorie per filtrare gli eventi.

• È possibile collegare i dati binari alla voce dell'evento se si desidera associare informazioni aggiuntive a un determinato evento.

Per un elenco di valori di proprietà iniziali per un'istanza di EventLog, vedere il EventLog costruttore.

Costruttori

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase