Al momento sei offline in attesa che la connessione Internet venga ristabilita

HOW TO: Scrivere in un registro eventi utilizzando C# .NET

Questo articolo è stato precedentemente pubblicato con il codice di riferimento I307024
Nel presente articolo viene illustrata una versione beta di un prodotto Microsoft. Le informazioni contenute in questo articolo vengono fornite "nello stato in cui si trovano" e sono soggette a modifiche senza preavviso.

Per questo prodotto beta Microsoft non fornisce alcun tipo di supporto formale. Per informazioni su come ottenere supporto per una versione beta, consultare la documentazione fornita con i file del prodotto beta oppure visitare il sito Web da cui la versione del prodotto è stata scaricata.

Per la versione di questo articolo relativa a Microsoft C# .NET vedere 301279.

Contenuto dell'attività

Sommario
In questo articolo viene illustrato come aggiungere voci personalizzate al registro eventi del sistema operativo utilizzando Microsoft .NET Framework.

Torna all'inizio

Requisiti

Nell'elenco che segue vengono descritti l'hardware, il software, l'infrastruttura di rete e i Service Pack necessari:
  • Microsoft Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server o Windows NT 4.0 Server.
  • Microsoft Visual Studio .NET.
Torna all'inizio

Scrivere in un registro eventi

La registrazione degli eventi rappresenta un metodo centralizzato standard tramite cui le applicazioni sono in grado di registrare eventi hardware e software importanti. Windows fornisce un'interfaccia utente standard per visualizzare i registri denominata Visualizzatore eventi. Utilizzando il componente run-timeEventLogdel linguaggio comune, è possibile accedere facilmente ai vari registri eventi esistenti sia nei computer locali che in computer remoti per aggiungervi delle voci. È anche possibile leggere le voci presenti nei registri esistenti e creare registri eventi personalizzati. Nella sua forma più semplice, la scrittura in un registro eventi prevede solo qualche passaggio per creare un'applicazione di esempio:
  1. Aprire Visual Studio .NET.
  2. Creare una nuova applicazione console in Microsoft C#. Visual C# .NET crea una classe pubblica assieme a un metodoMain()vuoto.
  3. Assicurarsi che il progetto contenga almeno un riferimento aSystem.dll.
  4. Utilizzare l'istruzioneusingnegli spazi dei nomiSystemeSystem.Diagnosticsin modo che in seguito non sia più necessario qualificare dichiarazioni provenienti da questi spazi dei nomi nel codice. Queste istruzioni devono essere utilizzate prima di qualsiasi altra dichiarazione.
    using System;using System.Diagnostics;
  5. Per scrivere in un registro eventi è necessario disporre di varie informazioni: il messaggio, il nome del registro in cui scrivere (che verrà creato se non esiste già) e una stringa che rappresenta l'origine dell'evento. È possibile registrare una sola origine per ogni registro eventi, pertanto se si desidera scrivere messaggi in più registri eventi sarà necessario definire più origini.
    string sSource;string sLog;string sEvent;sSource = "dotNET Sample App";sLog = "Application";sEvent = "Sample Event";
  6. Ottenute tutte queste informazioni, è necessario per prima cosa utilizzare due metodi statici della classeEventLogper verificare se l'origine esiste. In caso negativo, creare l'origine associata a un particolare registro eventi. Se il nome del registro specificato non esiste, verrà creato automaticamente al momento in cui viene scritta la prima voce al proprio interno. Se non viene fornito alcun nome di registro nel metodoCreateEventSource, verrà utilizzato per impostazione predefinita il Registro applicazione.
    if (!EventLog.SourceExists(sSource))	EventLog.CreateEventSource(sSource,sLog);
  7. Per scrivere un messaggio in un registro eventi è possibile utilizzare il metodo staticoEventLog.WriteEntry, che presenta diverse versioni di overload. Nel codice riportato di seguito sono illustrati il metodo più semplice, che assume una stringa di origine e il relativo messaggio, e il metodo più complesso che supporta la specifica dell'ID evento e del tipo evento.
    EventLog.WriteEntry(sSource,sEvent);EventLog.WriteEntry(sSource, sEvent, EventLogEntryType.Warning,  234);
  8. Salvare e quindi eseguire il codice e infine verificare il Registro applicazione nel Visualizzatore eventi per visualizzare i nuovi eventi.
Torna all'inizio

Elenco completo del codice

using System;using System.Diagnostics;namespace WriteToAnEventLog_csharp{	/// <summary>	/// Summary description for Class1.	/// </summary>	class Class1	{		static void Main(string[] args)		{			string sSource;			string sLog;			string sEvent;			sSource = "dotNET Sample App";			sLog = "Application";			sEvent = "Sample Event";			if (!EventLog.SourceExists(sSource))				EventLog.CreateEventSource(sSource,sLog);			EventLog.WriteEntry(sSource,sEvent);			EventLog.WriteEntry(sSource, sEvent,				EventLogEntryType.Warning, 234);		}	}}<BR/><BR/>
Torna all'inizio


Proprietà

ID articolo: 307024 - Ultima revisione: 04/08/2003 17:17:00 - Revisione: 1.0

Microsoft Visual C# .NET 2002 Standard Edition

  • kbhowto kbhowtomaster KB307024
Feedback