Como escrever um registo de eventos utilizando o Visual C#

Voltar ao topo

Requisitos

• Microsoft Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server ou Windows NT 4.0 Server
• Microsoft Visual Studio C#

Voltar ao topo

Escrever um registo de eventos

1. Abra o Visual Studio C#.
2. Crie uma nova aplicação de consola no Visual C#. A aplicação de consola cria uma classe pública e um método Main vazio.
3. Verifique se o projecto referenciado pelo menos o ficheiro System.dll.
4. Utilize a directiva utilizando espaços de nomes System.Diagnostics e de sistema para que não é necessário que qualificar declarações destes espaços de nomes mais tarde no código. Tem de utilizar estas instruções antes de quaisquer outras declarações.

   using System;
   using System.Diagnostics;
   					

5. Para escrever um registo de eventos, tem de ter várias partes de informação: A mensagem, o nome do registo ao qual pretende escrever (que será criada se não existir) e uma cadeia que representa a origem do evento. Pode registar uma determinada origem com apenas um registo de eventos; se pretender escrever mensagens mais do que um registo, tem de definir várias origens.

   string sSource;
   string sLog;
   string sEvent;
   
   sSource = "dotNET Sample App";
   sLog = "Application";
   sEvent = "Sample Event";
   					

6. Utilizar dois métodos estáticos da classe de registo de eventos para verificar se existe a origem e, em seguida, se a origem não existe, para criar esta origem está associada um determinado registo de eventos. Se o nome de registo que especificar não existir, o nome é criado automaticamente quando escreve a primeira entrada no registo. Por predefinição, se não fornecer um nome de registo para o método CreateEventSource , o ficheiro de registo é denominado "Registo de aplicações".

   if (!EventLog.SourceExists(sSource))
   	EventLog.CreateEventSource(sSource,sLog);
   					

7. Para escrever uma mensagem para um registo de eventos, pode utilizar o método estático EventLog.WriteEntry . Este método tem várias versões diferentes de sobrecarregado. O código de exemplo seguinte mostra o método mais simples, que utiliza uma cadeia de origem e a mensagem e um dos métodos mais complexos, que suporta a especificar o ID do evento e o tipo de evento:

   EventLog.WriteEntry(sSource,sEvent);
   EventLog.WriteEntry(sSource, sEvent, EventLogEntryType.Warning,  234);
   					

8. Guarde a aplicação. Executar a aplicação e, em seguida, consulte o registo aplicação no Visualizador de eventos para ver os novos eventos.

Voltar ao topo

Listagem de código completo

using System;
using System.Diagnostics;

namespace WriteToAnEventLog_csharp
{
	/// Summary description for Class1.
	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);
		}
	}
}
				

Voltar ao topo